{"id":20798829,"url":"https://github.com/helixml/helix","last_synced_at":"2026-06-17T10:01:20.115Z","repository":{"id":204905957,"uuid":"706031756","full_name":"helixml/helix","owner":"helixml","description":"♾️ Private Agent Fleet with Spec Coding. Each agent gets their own GPU-accelerated desktop. Run Claude, Codex, Gemini and open models on a full private AI Stack ♾️","archived":false,"fork":false,"pushed_at":"2026-06-15T17:58:13.000Z","size":242199,"stargazers_count":780,"open_issues_count":108,"forks_count":75,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-06-15T19:16:32.846Z","etag":null,"topics":["agents","api","genai","glm","golang","helm","k8s","kimi","llm","llm-agent","llm-serving","openai","openapi","qwen","rag","self-hosted","swagger","swarm"],"latest_commit_sha":null,"homepage":"https://helix.ml","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/helixml.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2023-10-17T07:11:12.000Z","updated_at":"2026-06-15T17:19:49.000Z","dependencies_parsed_at":"2024-04-15T18:56:04.181Z","dependency_job_id":"c4e6a309-bd13-4b3e-9b64-6512ea3904bc","html_url":"https://github.com/helixml/helix","commit_stats":{"total_commits":3003,"total_committers":12,"mean_commits":250.25,"dds":0.5374625374625375,"last_synced_commit":"1e6c19eeb1b9c66ef39d0d96edac365ab9a2b9f2"},"previous_names":["helixml/helix","tryhelixai/helix","lukemarsden/helix"],"tags_count":636,"template":false,"template_full_name":null,"purl":"pkg:github/helixml/helix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixml%2Fhelix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixml%2Fhelix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixml%2Fhelix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixml%2Fhelix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helixml","download_url":"https://codeload.github.com/helixml/helix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helixml%2Fhelix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34443239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","api","genai","glm","golang","helm","k8s","kimi","llm","llm-agent","llm-serving","openai","openapi","qwen","rag","self-hosted","swagger","swarm"],"created_at":"2024-11-17T17:04:00.270Z","updated_at":"2026-06-17T10:01:20.105Z","avatar_url":"https://github.com/helixml.png","language":"Go","funding_links":[],"categories":["Langchain"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg alt=\"logo\" src=\"https://helix.ml/assets/helix-logo.png\" width=\"250px\"\u003e\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://app.helix.ml/\"\u003eSaaS\u003c/a\u003e •\n  \u003ca href=\"https://helix.ml/docs\"\u003ePrivate Deployment\u003c/a\u003e •\n  \u003ca href=\"https://helix.ml/docs\"\u003eDocs\u003c/a\u003e •\n  \u003ca href=\"https://discord.gg/VJftd844GE\"\u003eDiscord\u003c/a\u003e\n\u003c/p\u003e\n\n# HelixML - AI Agents on a Private GenAI Stack\n\n[👥 Discord](https://discord.gg/VJftd844GE)\n\n**Deploy AI agents in your own data center or VPC and retain complete data security \u0026 control.**\n\nHelixML is an enterprise-grade platform for building and deploying AI agents with support for RAG (Retrieval-Augmented Generation), API calling, vision, and multi-provider LLM support. Build and deploy LLM applications by writing a simple [`helix.yaml`](https://helix.ml/docs) configuration file.\n\nOur intelligent GPU scheduler packs models efficiently into available GPU memory and dynamically loads and unloads models based on demand, optimizing resource utilization.\n\n## ✨ Key Features\n\n### 🤖 AI Agents\n- **Easy-to-use Web UI** for agent interaction and management\n- **Session-based architecture** with pause/resume capabilities\n- **Multi-step reasoning** with tool orchestration\n- **Memory management** for context-aware interactions\n- **Support for multiple LLM providers** (OpenAI, Anthropic, and local models)\n\n\u003cimg width=\"1768\" height=\"1053\" alt=\"AI Agents Interface\" src=\"https://github.com/user-attachments/assets/0e945ace-4f54-46a2-8d20-49485169486f\" /\u003e\n\n### 🛠️ Skills and Tools\n- **REST API integration** with OpenAPI schema support\n- **MCP (Model Context Protocol) server** compatibility\n- **GPTScript integration** for advanced scripting\n- **OAuth token management** for secure third-party access\n- **Custom tool development** with flexible SDK\n\n\u003cimg width=\"1767\" height=\"1057\" alt=\"Skills and Tools\" src=\"https://github.com/user-attachments/assets/575330f7-cfda-4e68-acd2-31617690ae69\" /\u003e\n\n### 📚 Knowledge Management\n- **Built-in document ingestion** (PDFs, Word, text files)\n- **Web scraper** for automatic content extraction\n- **Multiple RAG backends**: Kodit, LlamaIndex\n- **Vector embeddings** with PGVector for semantic search\n- **Vision RAG support** for multimodal content\n\n\u003cimg width=\"1772\" height=\"1055\" alt=\"Knowledge Base\" src=\"https://github.com/user-attachments/assets/c9112362-5f0e-4318-a648-4c478cd8d3fa\" /\u003e\n\n**Main use cases:**\n- Upload and analyze corporate documents\n- Add website documentation URLs to create instant customer support agents\n- Build knowledge bases from multiple sources\n\n### 🔍 Tracing and Observability\nContext is everything. Agents can process tens of thousands of tokens per step—Helix provides complete visibility under the hood:\n\n\u003cimg width=\"1767\" height=\"1053\" alt=\"Tracing Interface\" src=\"https://github.com/user-attachments/assets/81539015-18ae-4818-b396-3d872e55907f\" /\u003e\n\n**Tracing features:**\n- View all agent execution steps\n- Inspect requests and responses to LLM providers, third-party APIs, and MCP servers\n- Real-time token usage tracking\n- Pricing and cost analysis\n- Performance metrics and debugging\n\n### 🚀 Additional Features\n- **Multi-tenancy** with organization, team, and role-based access control\n- **Scheduled tasks** and cron jobs\n- **Webhook triggers** for event-driven workflows\n- **Evaluation framework** for testing and quality assurance\n- **Payment integration** with Stripe support\n- **Notifications** via Slack, Discord, and email\n- **Keycloak authentication** with OAuth and OIDC support\n\n## 🏗️ Architecture\n\nHelixML uses a microservices architecture with the following components:\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                      Frontend (React)                    │\n│                     vite + TypeScript                    │\n└────────────────────┬────────────────────────────────────┘\n                     │\n┌────────────────────▼────────────────────────────────────┐\n│                  API / Control Plane (Go)                │\n│  ┌──────────────┬──────────────┬──────────────────────┐ │\n│  │   Agents     │  Knowledge   │   Auth \u0026 Sessions    │ │\n│  │   Skills     │  RAG Pipeline│   Organizations      │ │\n│  │   Tools      │  Vector DB   │   Usage Tracking     │ │\n│  └──────────────┴──────────────┴──────────────────────┘ │\n└─────────┬──────────────────────────────────┬───────────┘\n          │                                  │\n┌─────────▼──────────┐            ┌─────────▼──────────┐\n│   PostgreSQL       │            │   GPU Runners      │\n│   + PGVector       │            │   Model Scheduler  │\n└────────────────────┘            └────────────────────┘\n          │\n┌─────────▼──────────────────────────────────────────────┐\n│  Supporting Services: Keycloak, Kodit, GPTScript       │\n│  Runner, Chrome/Rod, SearXNG                           │\n└────────────────────────────────────────────────────────┘\n```\n\n**Three-layer agent hierarchy:**\n1. **Session**: Manages agent lifecycle and state\n2. **Agent**: Coordinates skills and handles LLM interactions\n3. **Skills**: Group related tools for specific capabilities\n4. **Tools**: Individual actions (API calls, functions, scripts)\n\n## 💻 Tech Stack\n\n### Backend\n- **Go 1.24.0** - Main backend language\n- **PostgreSQL + PGVector** - Data storage and vector embeddings\n- **GORM** - ORM for database operations\n- **Gorilla Mux** - HTTP routing\n- **Keycloak** - Identity and access management\n- **NATS** - Message queue\n- **Zerolog** - Structured logging\n\n### Frontend\n- **React 18.3.1** - UI framework\n- **TypeScript** - Type-safe JavaScript\n- **Material-UI (MUI)** - Component library\n- **MobX** - State management\n- **Vite** - Build tool\n- **Monaco Editor** - Code editing\n\n### AI/ML\n- **OpenAI SDK** - GPT models integration\n- **Anthropic SDK** - Claude models integration\n- **LangChain Go** - LLM orchestration\n- **GPTScript** - Scripting capabilities\n- **Kodit / LlamaIndex** - RAG backends\n\n### Infrastructure\n- **Docker \u0026 Docker Compose** - Containerization\n- **Kubernetes + Helm** - Orchestration\n- **Flux** - GitOps operator\n\n## 🚀 Quick Start\n\n### Install on Docker\n\nUse our quickstart installer:\n\n```bash\ncurl -sL -O https://get.helixml.tech/install.sh\nchmod +x install.sh\nsudo ./install.sh\n```\n\nThe installer will prompt you before making changes to your system. By default, the dashboard will be available on `http://localhost:8080`.\n\nFor setting up a deployment with a DNS name, see `./install.sh --help` or read [the detailed docs](https://helix.ml/docs). We've documented easy TLS termination for you.\n\n**Next steps:**\n- Attach your own GPU runners per [runners docs](https://helix.ml/docs)\n- Use any [external OpenAI-compatible LLM](https://helix.ml/docs)\n\n### Install on Kubernetes\n\nUse our Helm charts for production deployments:\n- [Control Plane Helm Chart](https://helix.ml/docs)\n- [Runner Helm Chart](https://helix.ml/docs)\n\n## 🔧 Configuration\n\nAll server configuration is done via environment variables. You can find the complete list of configuration options in [`api/pkg/config/config.go`](https://github.com/helixml/helix/blob/main/api/pkg/config/config.go).\n\n**Key environment variables:**\n- `OPENAI_API_KEY` - OpenAI API credentials\n- `ANTHROPIC_API_KEY` - Anthropic API credentials\n- `POSTGRES_*` - Database connection settings\n- `KEYCLOAK_*` - Authentication settings\n- `SERVER_URL` - Public URL for the deployment\n- `RUNNER_*` - GPU runner configuration\n\nSee the [configuration documentation](https://helix.ml/docs) for detailed setup instructions.\n\n## 👨‍💻 Development\n\nFor local development, refer to the [Helix local development guide](./local-development.md).\n\n**Prerequisites:**\n- Docker Desktop (or Docker + Docker Compose)\n- Go 1.24.0+\n- Node.js 18+\n- Make\n\n**Quick development setup:**\n\n```bash\n# Clone the repository\ngit clone https://github.com/helixml/helix.git\ncd helix\n\n# Start supporting services\ndocker-compose up -d postgres keycloak\n\n# Run the backend\ncd api\ngo run . serve\n\n# Run the frontend (in a new terminal)\ncd frontend\nnpm install\nnpm run dev\n```\n\nSee [`local-development.md`](./local-development.md) for comprehensive setup instructions.\n\n## 📖 Documentation\n\n- **[Overview](https://helix.ml/docs)** - Platform introduction\n- **[Getting Started](https://helix.ml/docs)** - Build your first agent\n- **[Control Plane Deployment](https://helix.ml/docs)** - Production deployment guide\n- **[Runner Deployment](https://helix.ml/docs)** - GPU runner setup\n- **[Agent Architecture](./api/pkg/agent/SPEC.md)** - Technical specification\n- **[API Reference](https://helix.ml/docs)** - REST API documentation\n- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute\n- **[Upgrading Guide](./UPGRADING.md)** - Migration instructions\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.\n\nBy contributing, you confirm that:\n- Your changes will fall under the same license\n- Your changes will be owned by HelixML, Inc.\n\n## 📄 License\n\nHelix is [licensed](https://github.com/helixml/helix/blob/main/LICENSE.md) under a similar license to Docker Desktop. You can run the source code (in this repo) for free for:\n\n- **Personal Use:** Individuals or people personally experimenting\n- **Educational Use:** Schools and universities\n- **Small Business Use:** Companies with under $10M annual revenue and less than 250 employees\n\nIf you fall outside of these terms, please use the [Launchpad](https://deploy.helix.ml) to purchase a license for large commercial use. Trial licenses are available for experimentation.\n\nYou are not allowed to use our code to build a product that competes with us.\n\n### Why these license clauses?\n\n- We generate revenue to support the development of Helix. We are an independent software company.\n- We don't want cloud providers to take our open source code and build a rebranded service on top of it.\n\nIf you would like to use some part of this code under a more permissive license, please [get in touch](mailto:info@helix.ml).\n\n## 🆘 Support\n\n- **[Discord Community](https://discord.gg/VJftd844GE)** - Join our community for help and discussions\n- **[GitHub Issues](https://github.com/helixml/helix/issues)** - Report bugs or request features\n- **[Documentation](https://helix.ml/docs)** - Comprehensive guides and references\n- **[Email](mailto:info@helix.ml)** - Contact us for commercial inquiries\n\n## 🌟 Star History\n\nIf you find Helix useful, please consider giving us a star on GitHub!\n\n---\n\nBuilt with ❤️  by [HelixML, Inc.](https://helix.ml)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelixml%2Fhelix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelixml%2Fhelix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelixml%2Fhelix/lists"}