AI-powered business execution system that orchestrates specialized agents to automate real business tasks.
- POD Agent: Generates print-on-demand product ideas and content
- Marketing Agent: Creates social media posts and promotional material
- CRM Agent: Manages customer data, segments, and follow-ups
- Workflow Engine: Chains agents into multi-step automated workflows
- Scheduler: Runs workflows on cron schedules
- Real-time Dashboard: Monitor agents, jobs, and outputs via WebSocket
| Layer | Technology |
|---|---|
| Backend | Python 3.11 + FastAPI |
| Frontend | React 19 + Vite + TypeScript |
| Database | Supabase (PostgreSQL) |
| AI | Anthropic Claude (custom lightweight agents) |
| Orchestration | asyncio + APScheduler |
| Styling | Tailwind CSS 4 |
git clone https://github.com/Neo52000/JARVIS_OS.git
cd JARVIS_OS
cp .env.example .env
# Edit .env with your Supabase and Anthropic API keysRun backend/app/db/schema.sql in your Supabase SQL Editor to create all tables.
docker compose up --buildOr run services individually:
# Backend
cd backend && pip install -r requirements.txt && uvicorn app.main:app --reload
# Frontend
cd frontend && npm install && npm run dev- Frontend: http://localhost:5173
- Backend API: http://localhost:8000/api
- API Docs: http://localhost:8000/docs
- Health Check: http://localhost:8000/api/health
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/health |
Health check |
| GET | /api/agents |
List all agents |
| GET | /api/agents/{name} |
Agent details |
| POST | /api/agents/{name}/run |
Run an agent |
| GET | /api/workflows |
List workflows |
| POST | /api/workflows |
Create workflow |
| POST | /api/workflows/{id}/trigger |
Trigger workflow |
| GET | /api/jobs |
List jobs |
| GET | /api/jobs/{id} |
Job details |
| GET | /api/dashboard/stats |
Dashboard stats |
| WS | /api/ws |
Real-time updates |
backend/ Python FastAPI backend
app/
agents/ Agent framework + 3 agents
workflows/ Workflow engine + scheduler
api/ REST + WebSocket endpoints
db/ Supabase client + SQL schema
services/ AI + notifications
frontend/ React + Vite frontend
src/
pages/ Dashboard, Agents, Workflows, Jobs, Settings
components/ Layout, AgentCard, JobStatusBadge, LogViewer
hooks/ useAgents, useJobs, useWorkflows, useWebSocket
api/ HTTP client + WebSocket manager
make dev # Docker compose up
make dev-backend # Backend only
make dev-frontend # Frontend only
make test # Run backend tests
make lint # Lint both backend and frontend