| --- |
| title: Aubm |
| sdk: docker |
| app_port: 7860 |
| license: mit |
| short_description: Automated Business Machines |
| --- |
| |
| # 🤖 Aubm |
|
|
| ### Enterprise-Grade AI Agent Orchestration & Collaboration Platform |
|
|
| Aubm (Automated Unified Business Machines) is a sophisticated platform designed to orchestrate multiple autonomous AI agents to complete complex projects. Featuring **Human-in-the-Loop** supervision, **Dynamic DAG** task execution, and **Semantic RAG** context injection. |
|
|
| --- |
|
|
| ## 🚀 Key Features |
|
|
| - **Multi-Provider Support**: Seamless integration with OpenAI, AMD (inference.do-ai.run), Groq, Gemini, Qwen, Ollama, and OpenRouter. |
| - **Autonomous Orchestration**: Intelligent task prioritization and execution based on dependencies (DAG). |
| - **Human-in-the-Loop**: Approval-based workflow ensuring quality and safety. |
| - **Semantic Backpropagation**: Context from completed tasks is automatically injected into subsequent tasks. |
| - **Real-time Monitoring**: SSE-powered live logs and progress tracking. |
| - **Project Wizard**: AI-driven project creation and task decomposition. |
| - **Operational Safety**: Automatic recovery of stale runs and comprehensive health monitoring. |
|
|
| --- |
|
|
| ## 🛠️ Tech Stack |
|
|
| - **Frontend**: React + Vite + TypeScript (Styled with Vanilla CSS for maximum performance) |
| - **Backend**: FastAPI (Python 3.10+) |
| - **Database**: Supabase (Postgres + Auth + Real-time) |
| - **Deployment**: Optimized for Vercel (Serverless Backend + Static Frontend) |
|
|
| --- |
|
|
| ## 🏗️ Project Structure |
|
|
| ```bash |
| aubm/ |
| ├── backend/ # FastAPI Application & AI Core |
| │ ├── agents/ # LLM Provider Implementations |
| │ ├── routers/ # API Endpoints (Runner, Orchestrator) |
| │ ├── services/ # Business Logic (Queue, RAG, Guards) |
| │ └── main.py # App Entrypoint |
| ├── frontend/ # React Application |
| │ ├── src/ # Components, Hooks, Context, Services |
| │ └── vite.config.ts # Vite Configuration |
| └── database/ # Supabase Schema & Migrations |
| ``` |
|
|
| --- |
|
|
| ## ⚙️ Getting Started |
|
|
| ### 1. Database Setup (Supabase) |
| 1. Create a new project in [Supabase](https://supabase.com). |
| 2. Go to the **SQL Editor** and execute the content of `backend/schema.sql`. |
| 3. Enable **Auth** with your preferred providers (Email/Password by default). |
|
|
| ### 2. Backend Installation |
| ```bash |
| cd backend |
| python -m venv venv |
| source venv/bin/activate # or venv\Scripts\activate on Windows |
| pip install -r requirements.txt |
| ``` |
|
|
| Create a `.env` file in `/backend`: |
| ```env |
| SUPABASE_URL=your_project_url |
| SUPABASE_SERVICE_ROLE_KEY=your_service_role_key |
| OPENAI_API_KEY=optional_key |
| GROQ_API_KEY=optional_key |
| TAVILY_API_KEY=optional_key |
| # See SPEC.md for all available providers |
| ``` |
|
|
| Run the server: |
| ```bash |
| uvicorn main:app --reload --port 8000 |
| ``` |
|
|
| ### 3. Frontend Installation |
| ```bash |
| cd frontend |
| npm install |
| ``` |
|
|
| Create a `.env` file in `/frontend`: |
| ```env |
| VITE_API_URL=http://localhost:8000 |
| VITE_SUPABASE_URL=your_project_url |
| VITE_SUPABASE_ANON_KEY=your_anon_key |
| ``` |
|
|
| Run the development server: |
| ```bash |
| npm run dev |
| ``` |
|
|
| --- |
|
|
| ## 📈 Operational Modes |
|
|
| - **Embedded Worker**: Runs the task queue within the FastAPI process (set `TASK_QUEUE_EMBEDDED_WORKER=true`). |
| - **Standalone Worker**: For high-load environments, run the worker in a separate process: |
| ```bash |
| cd backend |
| python worker.py |
| ``` |
|
|
| --- |
|
|
| ## Hugging Face Spaces |
|
|
| This repository is ready to deploy as a Docker Space. Create a Hugging Face Space with SDK `Docker`, then push this repo to the Space remote. |
|
|
| Configure these Space secrets or variables: |
|
|
| ```env |
| SUPABASE_URL=your_project_url |
| SUPABASE_SERVICE_ROLE_KEY=your_service_role_key |
| SUPABASE_ANON_KEY=your_anon_key |
| GROQ_API_KEY=optional_key |
| OPENAI_API_KEY=optional_key |
| GEMINI_API_KEY=optional_key |
| AMD_API_KEY=optional_key |
| TAVILY_API_KEY=optional_key |
| TASK_QUEUE_EMBEDDED_WORKER=true |
| ``` |
|
|
| `VITE_API_URL` can stay empty on Spaces because the frontend calls the FastAPI backend on the same origin. |
|
|
| --- |
|
|
| ## 📄 Documentation |
|
|
| For detailed technical architecture, refer to: |
| - [SPEC.md](./SPEC.md) - Deep technical specifications. |
| - [ROADMAP.md](./ROADMAP.md) - Future development goals. |
| - [docs/](./docs/) - Extended guides and manuals. |
|
|
