Self-hosting Mnemo

Run the full Mnemo stack on your own infrastructure. Free forever. MIT licensed.

What you need

Supabase
Your database + auth
Free tier: 500MB, 2 projects
Mem0
Agent memory storage
Free tier: 1000 memories
Langfuse
Observability traces
Free tier: 50k events/month
Anthropic
AI Cop analysis
Pay per use — cheap with Haiku
Railway
API hosting
Free tier: $5 credit/month

Step by step

1Clone the repo
git clone https://github.com/DharmaDhillon/mnemo
cd mnemo
2Set up Supabase

Create a new Supabase project at supabase.com. Go to SQL Editor and run the schema from db/schema.sql. Copy your Project URL and service role key from Settings → API.

3Set up your environment

Copy the example env file and fill in your keys:

cp api/.env.example api/.env
# api/.env
MNEMO_SUPABASE_URL=your-project-url
MNEMO_SUPABASE_SERVICE_KEY=your-service-key
MNEMO_MEM0_API_KEY=from-app.mem0.ai
MNEMO_LANGFUSE_PUBLIC_KEY=from-langfuse
MNEMO_LANGFUSE_SECRET_KEY=from-langfuse
ANTHROPIC_API_KEY=from-console.anthropic.com
4Deploy your API to Railway
npm install -g @railway/cli
railway login
cd api
railway up

Railway gives you a URL like https://your-app.up.railway.app — save this.

5Connect your SDK

Python:

pip install mnemo-sdk[all]

from mnemo import MnemoClient
mnemo = MnemoClient(
  tenant_id="my-company",
  api_url="https://your-app.up.railway.app"
)
result = mnemo.run(
  agent_id="my-agent",
  prompt="..."
)

TypeScript / Next.js:

# .env.local
MNEMO_API_URL=https://your-app.up.railway.app
MNEMO_TENANT_ID=my-company
6View your dashboard

Sign up free at usemnemo.com. Go to Settings → Connected Tenants. Add your tenant_id. Your agents will appear automatically.

Need help?

Stuck? Open an issue or email directly.

Open GitHub IssueEmail Dharma