freshcrate
Skin:/
Home > AI Agents > Vrooli

Vrooli

Open-source, self-improving autonomous agent swarm🐇

Why this rank:Strong adoptionRelease freshnessHealthy release cadence

Description

Open-source, self-improving autonomous agent swarm🐇

README

Vrooli logo with motto

Your Personal Software Development Server

Imagine having your own AI development team that works entirely on your hardware.

Vrooli is the first platform that lets you generate complete applications locally - UI, API, database, CLI - without sending your data to the cloud or depending on external services. Tell it what you want to build, and it creates working software in hours using 30+ local services running on your machine.

🔒 Your Code. Your Data. Your Hardware. Your Control.

🚀 Quick Start

# First time setup (installs CLI, configures resources)
make setup

# Start development environment
make dev

# Run tests
make test

# See all commands
make help

Alternative commands:

./scripts/manage.sh setup   # Direct setup script
vrooli develop             # Use CLI after setup
vrooli --help              # See all CLI commands
Vrooli.com
Star Our Repo
Follow @VrooliOfficial
Subscribe @Vrooli
License: AGPLv3

Table of Contents

Why Vrooli Changes Everything

🏠 True Privacy & Control

  • Everything runs on YOUR hardware - databases, AI models, applications
  • Zero external API dependencies after initial setup
  • Your proprietary business logic never leaves your network
  • Perfect for sensitive industries (healthcare, finance, defense, research)
  • Fully customizable security and compliance to your exact requirements

🚀 AI Development Team in a Box

  • Generate complete applications: web UI + REST API + CLI + database
  • 30+ integrated local services (databases, AI models, automation, storage)
  • Modify AI-generated code safely - changes are preserved permanently
  • Compose applications from small, focused scenarios (few thousand lines each)

🔧 Modular Application Building

Your applications aren't monolithic. They're built from composable scenarios:

  • Core scenarios: Generate base app (UI + API + database + CLI)
  • Enhancement scenarios: Add features (ui-component-manager, account-manager, branding-manager)
  • Platform scenarios: Deploy and customize (app-to-ios, deployment-manager, app-issue-tracker)
  • Meta-scenarios: The system improves itself (ecosystem-manager, system-monitor)

💰 Real Business Value

The applications Vrooli generates aren't demos - they're production-ready tools that businesses typically pay $10K-50K to develop. Whether for internal use or client delivery, you're getting genuine enterprise-grade software.

How It Works

  1. Tell Vrooli What You Want: Describe your application in plain English
  2. AI Orchestrates Local Resources: Combines databases, workflows, UI frameworks automatically
  3. Complete Application Generated: Working software with UI, API, CLI, and database
  4. Customize and Enhance: Modify the code - your changes are automatically detected and preserved
  5. Compose Additional Features: Add scenarios for iOS deployment, branding, debugging, monitoring

The genius is in the scenario modification system: AI generates your initial application, but when you customize it, those changes are detected and preserved. Future scenario updates won't overwrite your modifications.

Current Resource Categories: Storage, Automation, AI Models, Databases, UI Frameworks, Development Tools Coming Soon: Home Automation, Physics Simulation, 3D Printing, CAD Integration, IoT Management

The Future of Software Development

Our vision: Every household and business running their own Vrooli server.

Instead of depending on cloud services and external APIs, imagine:

  • Your smart home running custom automation built by your personal AI
  • Your business generating internal tools instantly without external developers
  • Your family's personal assistant, photo manager, and productivity apps - all private
  • Your company's sensitive processes automated without data ever leaving your premises
  • Healthcare providers processing patient data with complete privacy
  • Financial institutions running proprietary algorithms on their own hardware

We're building the infrastructure for a locally-sovereign digital future.

Learn more about our business server solutions →

Installation

💾 Local Server (Recommended)

Run Vrooli on your own infrastructure with complete control and privacy:

# Quick setup with default resources (includes Ollama AI models)
./scripts/manage.sh setup

# Start your personal development server
vrooli develop

Why Local? This unlocks Vrooli's full potential:

  • Complete Privacy: Your code, data, and AI models never leave your hardware
  • Full Resource Access: 30+ local services for building complete applications
  • No External Dependencies: Generate applications even when offline
  • Enterprise Ready: Perfect for sensitive business environments

See detailed setup guide →

🌐 Hosted Service (Alternative)

Prefer not to manage your own server? We also offer a hosted version at vrooli.com with privacy-focused features:

  • Your data stays in your chosen region
  • No tracking or advertising
  • Full data export/deletion controls
  • Option to migrate to local deployment anytime

Private hosting guide →

Quick Tutorial

Video coming soon! In the meantime, new accounts will be greeted with an interactive tutorial that will guide you through:

  1. First Application: Generate a personal task manager with UI, API, and CLI
  2. Customization: Modify the generated code to fit your needs
  3. Enhancement: Add features using additional scenarios
  4. Privacy Setup: Configure local-only operation

Example scenarios you'll learn to build:

  • Personal productivity tools
  • Business automation dashboards
  • Research and analysis applications
  • Custom workflows and integrations

Development

Vrooli uses a modern, privacy-first technology stack designed for local resource orchestration and AI-driven application generation.

Core Technologies

  • React + TypeScript: Type-safe frontend with real-time AI interaction
  • Node.js + Express: High-performance backend for local resource coordination
  • PostgreSQL + pgvector: Local database with AI embedding support
  • Docker: Containerized local services for security and isolation
  • Redis: Local caching and real-time coordination

Architecture Highlights

  • Local-First Design: Everything runs on your hardware
  • Scenario-Based: Modular, composable application templates
  • Resource Orchestration: 30+ integrated local services
  • AI Model Agnostic: Works with OpenAI, Anthropic, Mistral, local models
  • Privacy by Design: No external dependencies after setup

Detailed architecture documentation →

Privacy & Security

Vrooli's local-first architecture provides inherent security advantages:

Privacy by Design

  • Local Execution: All data processing happens on your hardware
  • No Cloud Dependencies: Generate applications completely offline
  • Configurable Security: Add encryption, compliance, monitoring as needed
  • Industry Ready: GDPR, HIPAA, SOX compliance capabilities

Security Features

  • Sandboxed Execution: Isolated containers for safe code generation
  • Permission Controls: Granular access based on roles and requirements
  • Audit Trails: Comprehensive logging for compliance and forensics
  • Emergency Controls: Immediate system halt for safety-critical situations

Complete security documentation →

This docs section provides a comprehensive overview of the project's structure, helping developers get familiar with the layout and organization of the codebase.

Follow this guide to set up your development environment, including step-by-step instructions and useful tips for efficient development.

Note: Running the setup process with sudo permissions automatically configures any required system settings for local resources.

CI/CD Pipeline

We have set up a CI/CD pipeline to automatically deploy changes to a development VPS whenever changes are pushed to the development branch. This allows for quick testing and validation of changes before they are merged into the main branch and deployed to production.

For detailed instructions on how to set up and use the CI/CD pipeline, see the CI/CD Setup documentation.

Contributing

Multilingual Support

Vrooli is building the future of local-first software development. We welcome contributions from developers who share our vision of digital sovereignty.

How to Contribute

  • Scenario Development: Create new application templates for the community
  • Resource Integration: Add support for new local services and tools
  • Platform Development: Core platform improvements and optimizations
  • Documentation: Help others understand and use Vrooli effectively
  • Translation: Make Vrooli accessible in multiple languages

Current Priorities

  • Local resource integrations (home automation, 3D printing, IoT)
  • Enterprise scenario templates (healthcare, finance, manufacturing)
  • Mobile and desktop application deployment scenarios
  • Community scenario marketplace development

Join the Team

Get Started

  1. Check our project board for open tasks
  2. Read the development guide
  3. Join our community discussions
  4. Submit pull requests for review

As we become profitable, we'll add bounty rewards for completed contributions. This is your chance to shape the future of local-first development.

Contact the maintainer →

Privacy & Data

Vrooli is designed with privacy as the foundation, not an afterthought.

Local-First Privacy

  • Your Hardware, Your Data: When running locally, all data stays on your machine
  • No Cloud Dependencies: Generate applications completely offline
  • Zero Tracking: No analytics, ads, or external data collection
  • Complete Control: You own and control every piece of data

Hosted Service Privacy

If you use our hosted service:

  • Minimal Data Collection: Only what's necessary for operation
  • Clear Data Boundaries: Always know what's private vs. public
  • Full Export/Deletion: Complete control over your data
  • No Third-Party Sharing: Your data is never sold or shared
  • Compliance Ready: GDPR and CCPA compliant

Enterprise & Sensitive Data

Perfect for industries requiring strict data control:

  • Healthcare: HIPAA-compliant local deployment
  • Finance: Regulatory compliance with local data processing
  • Defense: Air-gapped environments supported
  • Research: Proprietary algorithms stay completely private

Complete privacy policy →

License

Vrooli is released under the GNU Affero General Public License v3.0 (AGPLv3).

Why AGPL 3.0?

  • Freedom and Transparency: Ensures all improvements remain open source, even for network services
  • Community Growth: Encourages collaborative development and shared innovation
  • Anti-Vendor Lock-in: Prevents proprietary capture of community contributions
  • Local Sovereignty: Supports the vision of personal, local-first computing

The AGPL ensures that Vrooli will always remain free software that empowers users, not vendors.

Release History

VersionChangesUrgencyDate
v3.2.0# v3.2.0 - Command Release ## The Pocket Command Bridge <img width="1024" height="1536" alt="Glowing device in cyberpunk command center" src="https://github.com/user-attachments/assets/3c447442-d1e9-44d8-98bd-90611007c182" /> ### **Help us spread the word by starring the repo or [sharing on X](https://twitter.com/intent/tweet?text=Vrooli%203.1.0%20Ascension%20is%20here%20%E2%80%94%20the%20self-improving%20intelligence%20system%20gets%20smarter!&url=https%3A%2F%2Fvrooli.com)** ### **NHigh4/10/2026
v3.1.0# v3.1.0 - Ascension Release ## The Intelligence Refinery <img width="1024" height="1024" alt="ChatGPT Image Jan 9, 2026, 07_36_31 AM" src="https://github.com/user-attachments/assets/3c9cee46-d599-491e-b62f-96f6e1fdbfd4" /> ### **Help us spread the word by starring the repo or [sharing on X](https://twitter.com/intent/tweet?text=Vrooli%203.1.0%20Ascension%20is%20here%20%E2%80%94%20the%20self-improving%20intelligence%20system%20gets%20smarter!&url=https%3A%2F%2Fvrooli.com)** ### **NOTLow1/9/2026
v3.0.0# v3.0.0 - Phoenix Release🔥 Autonomous Software Foundry <img width="1024" height="1024" alt="5d9b6118-9b4f-4f30-8aca-6a3355bfee02" src="https://github.com/user-attachments/assets/c35ed13f-f89a-4150-b06a-09603dfddb00" /> ### **🤗 Help us spread the word by starring the repo or [sharing on X](https://twitter.com/intent/tweet?text=Vrooli%203.0.0%20is%20here%20%E2%80%94%20the%20autonomous%20software%20foundry%20reborn!&url=https%3A%2F%2Fvrooli.com) 💖** ### **NOTE:** Vrooli 3.0.0 is a compleLow10/20/2025
v1.9.9# v1.9.9 - Improved Routine Building🏗️ ### **🤗 Help us spread the word about Vrooli by smashing that star button or [posting on X](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ### **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which will be rolling out soon. ## 🚀 **Major FeatuLow7/16/2024
v1.9.8# v1.9.8 - Chatbot improvements🤖 Performing tasks🏃‍♂️ UX improvements📲 ### **🤗 Help us spread the word about Vrooli by smashing that star button or [posting on X](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ### **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which will be rollinLow6/18/2024
v1.9.7# v1.9.7 - Chatbots🤖 UX improvements📲 Improved server operations🏗️ ### **🤗 Help us spread the word about Vrooli by smashing that star button or [posting on X](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ### **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which will be rolling ouLow1/2/2024
v1.9.6# v1.9.6 - UX improvements📲 UI performance🏎️ AI preparations🪄 ### **🤗 Help us spread the word about Vrooli by smashing that star button or [posting on X](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ### **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which will be rolling out sooLow9/6/2023
v1.9.5# v1.9.5 - Minor improvements to complement 1.9.4😊 ### **🤗 Help us spread the word about Vrooli by smashing that star button or [tweeting](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ## **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which will be rolling out soon. ## 🤔 OverviLow8/3/2023
v1.9.4# v1.9.4 - Bots🤖 Profile pictures📷 More AI preparations🧠 Bug fixes🪲 UI improvements📲 ### **🤗 Help us spread the word about Vrooli by smashing that star button or [tweeting](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ## **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which wiLow8/1/2023
v1.9.3# v1.9.3 - Improved standards📃 More AI preparations🧠 API changes🏎️ Bug fixes🪲 UI improvements📲 ### **🤗 Help us spread the word about Vrooli by smashing that star button or [tweeting](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ## **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing featuresLow6/30/2023
v1.9.2# v1.9.2 - AI preparations🧠 Bug fixes🪲 UI improvements📲 ### **🤗 Help us spread the word about Vrooli by smashing that star button or [tweeting](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ## **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which will be rolling out soon. ## ���Low5/30/2023
v1.9.1# v1.9.1 - Bug fixes🐛 UI improvements📲 and docs📜 ### **🤗 Help us spread the word about Vrooli by smashing that star button or [tweeting](https://twitter.com/intent/tweet?text=New%20%40VrooliOfficial%20version%20just%20dropped%F0%9F%8E%A4&url=https%3A%2F%2Fvrooli.com) about the release 💖** ## **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which will be rolling out soon. ## 🤔 OverviLow5/1/2023
v1.9.0# v1.9.0 - Setting up for greatness💪 <img src="https://media1.giphy.com/media/mjzpnK2eBSuWs/giphy.gif"/> ## **NOTE:** While you can visit the site now, this is essentially a pre-build release for version 2.0.0. There are a ton of bugs and missing features, which will be rolling out over the next few weeks. ## 🤔 Overview This pull request upgrades the Vrooli app to version 1.9, introducing several significant changes aimed at improving the overall user experience and preparing the appLow4/15/2023
v.1.3.2# v1.3.2 - Mobile & quality of life improvements📱💖 <img src="https://media2.giphy.com/media/MTclfCr4tVgis/giphy.gif"/> ## Major features - Ability to log in with multiple accounts, and switch them quickly using a new AccountMenu dialog - UX is much improved, especially for mobile users (and especially for PWA) - Search bars store your past searches. This data can be cleared in settings - Building multi-step routines now supports multiple languages, looks better, and is easier to navigaLow10/23/2022
v1.3.0# v1.3.0 - Navigation, undo/redo, private objects, & more! <img src="https://media4.giphy.com/media/4LPxINAIcA72lohDYE/giphy.gif"/> # Major Changes - Created search pages to support stars, history, runs, and more - Improved reporting and added page to view reports - Created the Command Palette, which allows for quick access to shortcuts and routines - Added undo/redo to building routines - Added public/private support for objects - Improved site navigation - Started adding custom iconLow9/5/2022
v1.2.0# v1.2.0 - Run improvements and bug fixes <img src="https://media3.giphy.com/media/11ZSwQNWba4YF2/giphy.gif"/> - Inputs entered when running routines are now stored, and repopulate when you continue the routine - Fixed many bugs related to building and running routines - Refactored database, server, and API to prepare for object versioning, advanced permissioning, organization roles, public API support, and more - Fixed several bugs related to querying complex objects - Added ability to Low8/7/2022
v1.1.3# v.1.1.3 - Increased type safety, new scripts, & more <img src="https://media4.giphy.com/media/ppcPOCojxincokmTjp/giphy-downsized-medium.gif"/> - Added more type safety when creating/updating objects - Added type safety to the pub/sub architecture - Authentication now supports more CIP-0030 wallets (any that work without any special tricks). These are read from window.cardano, instead of a predefined list - Less bugs when building multi-step routines (but you may still run into them) - Low7/20/2022
v1.1.2- Copy and fork routines - Comment on routines and standards - Improved logging of run progress - Delete confirmation dialog for objects - Edit and delete added to vertical resource lists - Delete runs from run picker dialog - Improved view on mobile - Code cleanup - Renamed "Home" to "For You" and "For You" to "History" - Added search bar to history page - Bug fixesLow6/25/2022
v1.1.1- iOS navigation bar doesn't cover app content anymore - Added default node when creating a new multi-step routine - Improved API - Minor bug fixesLow6/8/2022
v1.1The long-anticipated version 1.1 of Vrooli is complete! Features since the last minor update are... - Auto-generated inputs when running routines - Improved routine building - Delete functionality implemented - Stacking order in UX for arbitrary nesting - Improved UX - Improved API - Bug fixes Total features added since version 1 are...🥁🥁🥁 - Standards can be added, updated, and viewed correctly - Ability to add inputs/outputs to routines, with standards attached - Standards aLow6/3/2022
v1.0.4.1- Fixed querying of "For You" page - UX improvements - API improvements - Bug fixesLow5/29/2022
v1.0.4- Looks more like a native app when PWA is downloaded from the browser - Added splash screens, both for light mode and dark mode - Added screenshots for upcoming Google Play store integration - Minor UX improvements for better display on mobileLow5/26/2022
v1.0.3- Improved UX and server performance🏎 - Improved mobile UX display📱 - Improved dark theme display🌝 - Standards further implemented🔥 - Bug fixes🐛Low5/24/2022
v1.0.2.3-Added dark mode -Improved UX -Can view active/completed routines -Can view starred/viewed objects -Simple routines can be marked as complete -Bug fixes and code cleanupLow5/17/2022
v1.0.2.2-Advanced search pages -For You page added. Allows you to see active routines, starred items, etc. -Quick actions in Home page search bar -Learn, research, and develop pages now query correctly -Cleaned up a bit of the ui code -Improved navigation -Fixed some issues with MongoDB logs -Lots of other bugs squashed🪲Low4/28/2022
v1.0.2.1This release fixes critical issues found with the website, among other things: -Added MongoDB to server, which handles logging of stats and user actions. Will be used to calculated in-progress routines, how long it is taking users to complete routines, etc -Postgres updated to handle citext columns. This is used for case-insensitive email logins -Redis updated to save snapshots -Website now automates refreshes service worker when the site updates. Hopefully this should take into effect immLow4/20/2022
v1.0.2- Set an ADA Handle as your username! 👀 - Basic add/update of inputs and outputs to routines ➕🔥 - Multi-translation support for most objects 🌍🤟 - Improved authentication flow 🔐 - Add and verify multiple wallets/emails to the same account 📧 - Verification email looks cleaner 😎 - Image now shown (hopefully) when sharing Vrooli links - API rate limiting 🛑✋ - Many bug fixes and minor improvements 🐛🧹Low4/17/2022
v1.01MVP version of Vrooli, with a few additional bug fixesLow3/28/2022
v0.9Website is stable enough to show the basics of how the MVP works. There are still some issues with creating/updating objects that needs to be addressed before v1.0Low3/15/2022

Dependencies & License Audit

Loading dependencies...

Similar Packages

sofiaAutonomous local AI assistant in Go — 40+ tools, 20+ LLM providers, multi-agent orchestration, self-improvingmain@2026-04-23
skalesYour local AI Desktop Agent for Windows, macOS & Linux. Agent Skills (SKILL.md), autonomous coding (Codework), multi-agent teams, desktop automation, 15+ AI providers, Desktop Buddy. No Docker, no terv11.1.6
jobclawStreamline hiring by connecting AI agents that evaluate, negotiate, and schedule interviews to reduce time and improve candidate fit.main@2026-06-04
KREASYSBuild and manage projects with an autonomous browser-based IDE featuring integrated multi-modal AI tools for efficient development workflows.main@2026-06-04
serverlessclawOfficial ServerlessClaw: The authoritative autonomous AI agent swarm for AWS. Zero idle cost, self-evolving, and infinite scale. Powered by OpenClaw.main@2026-06-03

More in AI Agents

@blockrun/franklinFranklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.
hermes-agentThe agent that grows with you
awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.
e2bE2B SDK that give agents cloud environments