Skip to content

sameerchereddy/the-machine

Repository files navigation

Think. Act. Observe. That's The Machine.

A multi-provider AI agent platform. Bring your own LLM. The reasoning, the security, and the traces are on us.


Flowise, Langflow, and Dify wire LangChain components together. LangGraph gives you a loop to write yourself. LangSmith observes it — for a fee, separately.

The Machine is none of these.

Bring your credentials for any of 8 providers — encrypted per-user with AES-256-GCM, never stored in plaintext. A purpose-built ReAct loop runs against them. Every reasoning step, tool call, and decision is stored as a first-class trace in your own database.

No LangChain. No external observability service. No vendor picking your model.


Any LLM — OpenAI · Claude · Gemini · Grok · Bedrock · Azure · Ollama · Custom Real reasoning — multi-step ReAct loop, not a single prompt Full traces — every step, tool call, and token. First-party. Your DB. Your keys — AES-256-GCM encrypted, per-user, never returned to the client Built-in tools — web search, calculator, URL reader, Wikipedia, and more Knowledge base — upload docs, the agent retrieves from them on demand


Architecture

┌─────────────────────────────────────────┐
│           Browser (React + Vite)         │
│  /login  /agents  /traces               │
└──────────────────┬──────────────────────┘
                   │ HTTPS + WebSocket
┌──────────────────▼──────────────────────┐
│            FastAPI Backend               │
│  JWT auth · Agent API · WebSocket runs  │
└──────┬──────────────────────┬───────────┘
       │                      │
┌──────▼──────┐      ┌────────▼────────┐
│  ReAct Loop │      │    Supabase      │
│  + Tools    │      │  Postgres + RLS  │
└──────┬───────┘      │  pgvector        │
       │              │  Auth (JWT)      │
┌──────▼──────────┐   └─────────────────┘
│ Provider Adapter│
│ (custom, no     │
│  LangChain)     │
│ OpenAI · Claude │
│ Gemini · Grok   │
│ Bedrock · Azure │
│ Ollama · Custom │
└─────────────────┘

Quick Start

git clone https://github.com/sameerchereddy/the-machine.git
cd the-machine

# Backend env
cp .env.example backend/.env
# Fill in SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_KEY, SERVER_SECRET

# Frontend env
cp .env.example frontend/.env.local
# Fill in VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY, VITE_API_BASE_URL

# Apply database schema
supabase link --project-ref <your-project-ref>
supabase db push

# Backend
cd backend
pip install -e ".[dev]"
uvicorn app.main:app --reload  # http://localhost:8000

# Frontend (separate terminal)
cd ../frontend
npm install
npm run dev                    # http://localhost:5173

Stack

Layer Tech
Frontend React 18 + TypeScript + Vite + Tailwind + shadcn/ui
Backend FastAPI (Python 3.12, fully async)
Auth Supabase Auth (JWT, httpOnly cookies)
Database Supabase Postgres + pgvector
LLM routing Custom provider adapter (no LangChain, no LiteLLM)
Encryption AES-256-GCM, per-user envelope encryption
Deploy Fly.io (backend) + Vercel (frontend)

Docs

About

Multi-provider AI agent platform. Bring your own LLM — encrypted credentials, custom ReAct loop, first-party traces.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors