Velocity

Open Velocity 🌌 is not just another code editor or AI assistant. It's an ambitious open-source project to build a web-native, agent-first integrated development environment (IDE). Unlike proprietary platforms that lock you into a single AI ecosystem, Open Velocity is designed from the ground up to be a universal gateway to any LLM. Our goal is to create a platform where developers can delegate complex tasks to autonomous AI agents, powered by the models of their choice. 🤖✨

🌟 Why Open Velocity?

• 🔓 True Model Freedom: Building a future that isn't tied to a single AI provider.
• 🗳️ Democratizing AI: Making state-of-the-art agentic development accessible to everyone.
• 🛠️ Transparency & Extensibility: An open core that the community can shape, extend, and trust.
• 🏠 Self-Hosting & Privacy: Full control over your code, your data, and your AI connections.

✨ Core Features (The Vision)

• 🌌 Best of All Worlds: Fusing the best features of Cursor, Windsurf, Trae, and Velocity into a single, cohesive experience.
• 🧠 Google's Cutting Edge: Incorporating the powerful capabilities of Google CodeMender and Google Jules for state-of-the-art code generation.
• 🔒 Privacy First: No code or environment info is sent to third parties without your consent. Your data stays yours!
• 🔌 Universal LLM Gateway: Connect to GPT-4, Claude 3.5, Gemini 1.5 Pro, Llama 3, Deepseek, and more. A unified interface for all your agents.
• 🤖 Agent-First Workflow: Delegate high-level tasks to autonomous agents that plan, write, and verify code.
• 🤝 Multi-Agent Collaboration: Spawn multiple agents to work in parallel on different parts of your project.
• 🖼️ Verifiable Artifacts: Agents generate tangible artifacts (Task Lists, Screenshots, Test Results) so you can trust their work.
• 🔄 Interactive Feedback: Provide real-time feedback to agents as they work.

🧬 OpenCentravity v0.2.0 Backend Core (Implemented)

The underlying core engine (newcore/) has been completely upgraded to support enterprise-grade, concurrent multi-agent coordination. Key capabilities include:

• 💾 Sequential Migrations & Schema: A robust 14-table SQLite database layer (src/db/) supporting Write-Ahead Logging (WAL) and sequential schema migrations (0001–0014).
• 🔒 Connection Safety: A module-level promise mechanism blocks concurrent read/write queries from running on a partially-migrated database, eliminating race condition locks.
• 🤝 Hierarchical Swarms: Database tracking of parent-child relationships between agents, allowing complex workflows to branch out cleanly into swarms.
• 💬 Whiteboard Message Bus: A shared communication whiteboard (src/orchestrator/messagebus.ts) that enables sub-agents to broadcast statuses and coordinates their efforts.
• 🗝️ Distributed Lock Manager: File-level mutexes (src/orchestrator/locks.ts) that prevent overlapping writes or edit collisions by parallel agents on the same files.
• 📸 LWM Memory Snapshots: Snapshotting engine (src/memory/snapshot.ts) that saves agent memory states periodically, allowing agents to restore state and self-heal from failures.
• 💸 Cost Recorder & Caps: Monitors and persists input/output token counts and real-time API cost per LLM call, enabling strict swarm-level cost ceiling rules (MAX_COST_USD).
• 📟 Consolidated CLI Commands: Clean command suite including swarms, swarms inspect, swarms cancel, cost, db:status, db:backup, and db:backups.

🏛️ High-Level Architecture

Open Velocity is a modular, container-native application designed for flexibility and scale. 🏗️

graph TD
    UI[Web UI / Editor] --> GW[Gateway & Orchestrator]
    GW --> WM[Workspace Manager]
    GW --> AG[AI Model Gateway]
    WM --> Docker[Isolated Containers]
    AG --> LLMs[Gemini, Claude, GPT-4, Llama]

🚀 Roadmap

We have an ambitious journey ahead! 🗺️ Check out ROADMAP.md for the full details.

• Phase 1: 🏗️ Core Platform & Universal Gateway
• Phase 2: 🤖 Single-Agent Workflow & Tooling
• Phase 3: 🌌 Advanced Agentic Features (Multi-Agent)
• Phase 4: 🌈 Community & Extensibility

🛠️ Getting Started (Development)

Ready to build the future? 🛠️ Here’s how to get started locally.

Prerequisites:

• 🐳 Docker & Docker Compose
• 🟢 Node.js (v20+)
• 🐍 Python (v3.11+)

Installation:

1. Clone the repository:

   git clone https://github.com/ishandutta2007/open-velocity.git
   cd open-velocity
   

2. Setup environment variables:

   cp .env.example .env
   

   Fill in your API keys in the .env file. 🔑

3. Launch the environment:

   docker-compose up --build
   

   Access the platform at http://localhost:3000. 🌐

🙌 How to Contribute

We welcome contributions from everyone! 💖 Whether you're a developer, designer, or writer, there's a place for you.

• 📖 Check out the Contribution Guide.
• 🐛 Look at the Open Issues.
• 💬 Join our Discord Server.

🙌 Contributors

⭐ Star History

📜 Disclaimer

IMPORTANT: Please Read Carefully

1. Independent Project: Open Velocity is an independent, community-driven open-source project. It is NOT an official product of Google LLC, Alphabet Inc., or any of its affiliates. This project is not endorsed, sponsored, or supported by Google.
2. Trademarks: "velocity", "Gemini", "Google", and all related logos and brand names are trademarks or registered trademarks of Google LLC. The use of these names in this project is strictly for identification and descriptive purposes and does not imply any affiliation with or endorsement by the trademark owners.
3. Experimental Software: This tool is currently in an experimental/beta stage. It is provided "as is" without any warranties of any kind, express or implied. The authors and contributors are not responsible for any data loss, security vulnerabilities, or other issues arising from the use of this software.
4. Research & Development: Open Velocity is intended for research and development purposes only. It should not be used in production environments without thorough independent verification.
5. Third-Party Services: Users are responsible for their own use of third-party AI models and APIs (including but not limited to Google Gemini, OpenAI, and Anthropic). You must comply with the respective Terms of Service and Privacy Policies of those providers.

⚖️ License

This project is licensed under the MIT License. See the LICENSE file for details. 📄