Graxia OS — Personal AI Chief of Staff

Find leads, draft outreach, manage approvals, and track revenue — autonomously, with human oversight at every decision. Your personal sovereign OS for freelance, competition, and job pipelines.

---

Demo

🎬 Demo coming soon — 30s screen capture of the control plane in action will be added at docs/demo.gif

Control plane: opportunities → drafts → approvals → tasks → costs → event bus (React 18 + FastAPI)

# Run it yourself in 30 seconds:
docker compose --env-file .env.dev -f config/docker-compose.dev.yml up
# Frontend: http://localhost:5173

---

Why Graxia OS

Solo operators drown in leads, inboxes, and follow-ups. Graxia OS is a control plane, not a dashboard — it consolidates:

• Discovery from freelance boards, competitions, job sites, network leads, events
• Scoring via AI (fit / risk / effort / timing / next action) with cost-aware model routing
• Execution via Celery workers (scan, briefing, follow-up, email, backup, weekly review)
• Knowledge sync to Obsidian second brain — projects, contacts, tasks never leave your system

342 commits · production shape via Docker Compose + Supabase · 15+ Grafana alerts

---

Architecture

graph TD
  A[Sources: Freelance / Jobs / Inbox / Calendar / n8n] --> B[Scrapers & Adapters]
  B --> C[FastAPI Control Plane /api/v1]
  C --> D[Agents: Scout, Scorer, Drafter, Decision Engine]
  D --> E[Model Router: OpenClaw primary / Gemini fallback]
  E --> F[(Supabase PostgreSQL)]
  C --> G[Redis: Cache + Celery Broker]
  G --> H[Celery Workers: critical / default / background / dlq]
  H --> I[React 18 Control Plane :5173]
  H --> J[Telegram Alerts]
  H --> K[Obsidian Second Brain Sync]
  C --> L[Monitoring: Prometheus + Grafana + Loki + Sentry]

Loading

Stack: FastAPI + SQLAlchemy async + Alembic + PostgreSQL/Supabase · Redis + Celery Beat · React 18 + TypeScript + Vite + Bun · Caddy + n8n · Prometheus/Grafana/Loki

---

Quickstart (3 commands)

git clone https://github.com/bravforcode/graxia-os.git
cd graxia-os
cp .env.example .env  # set DATABASE_URL, SECRET_KEY, ADMIN_DEFAULT_EMAIL/PASSWORD

# Dev (with fallback without Postgres)
# Add USE_SQLITE_FALLBACK=true for offline dev
docker compose --env-file .env.dev -f config/docker-compose.dev.yml up

• API: http://localhost:8000 — docs at /docs · health at /health & /api/v1/system/health
• Frontend: http://localhost:5173
• n8n: http://localhost:5678

Prod (Supabase always-on):

cp .env.production.template .env.production  # fill ALL placeholders — strict validation
make supabase-preflight && make supabase-prod-migrate && make supabase-prod-up

Full runbook: docs/SUPABASE_PRODUCTION.md

---

Features — What Operator Gets

Capability	Detail
Lead Discovery	Multi-source scrapers + scheduled jobs + manual input
AI Scoring	Fit/risk/effort/timing with cheap/mid/high model tiers
Draft & Follow-up	Proposal drafts + briefing + follow-up with approval gate
Revenue Pipeline	Opportunities → Submissions → Email threads → Metrics
Cost Control	LLM usage ceilings + token tracking per tier
Second Brain	Obsidian daily note / weekly review / context sync

---

Results & Verification

• Backend canonical tests: backend/tests/ (SQLite fallback for determinism, verified against PostgreSQL before prod)
• Frontend: lint + unit + e2e (Playwright) + Storybook + bun run build
• Verification entry:

  .\verify.ps1        # Windows full
  make verify         # or make

• OpenAPI: cd backend && python scripts/export_openapi.py --output openapi.json

---

Tech Stack (Badges)

Layer	Tech
Backend	FastAPI · SQLAlchemy async · Alembic · JWT + CSRF + rate limit
Data	Supabase PostgreSQL · Redis · Celery Beat
Frontend	React 18 · TypeScript · Vite · Bun · Zustand · TanStack Query
Infra	Docker Compose · Caddy · n8n · Prometheus/Grafana/Loki/Flower
AI	OpenClaw (primary) · Gemini (fallback) · Model Router

---

Roadmap

• Control plane + approval gates + Celery beat (daily backup, DLQ, scan, briefing)
• Live Google Workspace + Telegram + LLM verification on real creds
• Broaden E2E on live stack + Lighthouse/accessibility audit
• Rewrite backend/tests_legacy/ against current /api/v1

---

Contact

Phirawit Jitnarong — Strategic Full-Stack & AI Engineer nxme176@gmail.com · 092-551-0427 · LinkedIn · Fastwork

Looking for a technical co-founder or full-time AI + Full-Stack hire? Let's build.