Genbase v0.1.0-alpha

Genbase is an open-source platform for building and orchestrating complex AI systems using modular, reusable agents called Kits.

Our goal with this release is to gather early feedback on the core concepts and workflow. Please note that this is an early version – expect rough edges and potential changes.

✨ Key Features in Alpha 0.1.0:

• Core Concepts: Create Projects, upload/install local Kits (kit.yaml, actions, workspace), and instantiate them as Modules.
• Agent Interaction: Chat with Module agents through defined Profiles using a configurable LLM backend (via LiteLLM).
• Secure Execution: Kit Actions run in isolated container runtime with managed dependencies and environment variables.
• Basic Management: Engine API (FastAPI) and Studio UI (React) for managing projects, local kits, modules, and basic agent chat.
• Foundational Services: Includes database persistence (PostgreSQL), user authentication (JWT), basic Kit Registry interaction (install only).

🚀 Getting Started (Docker Recommended)

1. Clone the repo: git clone https://github.com/genbase-project/genbase.git && cd genbase
2. Copy .env templates: cp *.template *.env inside docker/, engine/, and studio/.
3. Edit engine/.env: Set ADMIN_PASSWORD, DATABASE_URL, AUTH_SECRET, and at least one LLM API key (e.g., OPENAI_API_KEY).
4. Make scripts executable: chmod +x scripts/*.sh
5. Start: ./scripts/docker-run.sh up
6. Access Studio: http://localhost:5173 (login: admin / your password).

(See README.md for full details).

⚠️ Alpha Limitations:

• Stability: Expect bugs and potential API changes.
• UI/UX: The Studio is functional but needs polish and more features.
• Kit Registry: Focus is on local Kit management; registry features are basic (install only).
• Documentation: Guides for Kit development are limited.
• Error Handling: Basic error reporting; debugging may require checking logs.

📝 Feedback Needed!

We value your input on:

• The overall concept and workflow.
• Ease of setting up and using the platform.
• The Kit creation process (if attempted).
• Any bugs or usability issues encountered.

Please use GitHub Issues for bugs/features and GitHub Discussions for questions.

What's Next?

We'll focus on stabilizing the core platform, improving the Kit developer experience, enhancing the Studio UI, and building out full Kit Registry functionality based on your feedback.