Quickstart

git clone https://github.com/saxenauts/persona.git
cd persona

cp .env.example .env

# LLM Services
LLM_SERVICE=openai/gpt-5.2
EMBEDDING_SERVICE=openai/text-embedding-3-small
OPENAI_API_KEY=sk-your-key-here

# Neo4j Database
# Use bolt://neo4j:7687 for Docker (default)
# Use bolt://localhost:7687 if running server locally
URI_NEO4J=bolt://neo4j:7687
USER_NEO4J=neo4j
PASSWORD_NEO4J=password

docker compose up -d

curl -X POST http://localhost:8000/api/v1/users/alice

curl -X POST http://localhost:8000/api/v1/users/alice/ingest \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Had a great meeting with Sarah about the Q4 roadmap. I prefer morning meetings and want to finish the project by Friday.",
    "source_type": "conversation"
  }'

curl -X POST http://localhost:8000/api/v1/users/alice/rag/query \
  -H "Content-Type: application/json" \
  -d '{"query": "What are my current priorities?"}'

# Install dependencies
poetry install

# Start Neo4j in Docker only
docker compose up -d neo4j

# Update .env to use localhost
# URI_NEO4J=bolt://localhost:7687

# Run the API
poetry run uvicorn server.main:app --reload