Memoro

A personal CRM for tracking daily interactions with people in your life. Record contact details, interactions, and use semantic search to find context about your relationships.

Tech Stack

FastAPI • PostgreSQL • HTMX • OpenAI API

Prerequisites

• Python 3.11+
• uv
• just

Quick Start (Local Dev)

# Install dependencies
just install

# Configure environment
cp .env.example .env
# Edit .env with your OPENAI_API_KEY and Firebase credentials

# Start database
docker-compose up -d

# Run migrations
just db-migrate

# Start server
just dev

Visit http://localhost:8000

Deploy to Fly.io

# Prerequisites: brew install flyctl && fly auth login

# One-time setup (interactive):
./scripts/setup-fly.sh

# Migrate local data:
./scripts/migrate-data-fly.sh

# Future deploys:
fly deploy

Keyboard Shortcuts

• cmd+k (or ctrl+k) - Focus search bar
• cmd+. (or ctrl+.) - New interaction

Commands

just dev              # Start dev server
just test             # Run tests
just format           # Format code
just lint             # Lint code

just db-migrate       # Apply migrations
just db-rollback      # Rollback migration
just db-shell         # PostgreSQL shell

Documentation

• API docs: http://localhost:8000/docs
• Architecture: claude.md