.env.example
Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.
OPENROUTER_API_KEY
secret
OpenRouter API key (for embeddings and LLM extraction)
SAMANTHA_WORKSPACE_PATH
Workspace path — directory containing SOUL.md, STATE.md, AGENTS.md, etc.
SAMANTHA_QDRANT_HOST
SAMANTHA_QDRANT_PORT
SAMANTHA_QDRANT_COLLECTION
SAMANTHA_QDRANT_ARCHIVE_COLLECTION
SAMANTHA_EMBEDDING_MODEL
SAMANTHA_EMBEDDING_DIM
SAMANTHA_EXTRACTION_MODEL
SAMANTHA_EMOTIONAL_SEEDS
Emotional seed words for random retrieval pool
SAMANTHA_BACKUP_PATH
Backup path
LOG_LEVEL
Logging
brew install flyctl && fly launch --from https://github.com/claudiodrews/project-samantha
curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/claudiodrews/project-samantha
iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/claudiodrews/project-samantha