Memoria documentation

The detailed docs live in the GitHub repository. This page links to them and lists the API endpoints.

Architecture
Diagram, data flows, memory tiers and components.
docs/ARCHITECTURE.md · Summary on this site
MCP skills
Four memory tools at GET /mcp/memory-skills.
backend/app/mcp/memory_skill.py
Deployment
Terraform for Alibaba Cloud ECS, ApsaraDB PostgreSQL and Redis. The README also documents safe updates.
infrastructure/acs_deployment.tf · backend/Dockerfile · docker-compose.yml
Security
Report vulnerabilities privately. Secrets are scanned with gitleaks.
SECURITY.md
Configuration
Supported environment variables.
.env.example · Setup guide
More
Roadmap and project narrative.
Roadmap · Blog post · README

API endpoints

Routes defined in backend/app/api. With the stack running, interactive docs are at http://localhost:8000/docs.

Method	Path	Purpose
POST	`/auth/signup`	Create a user
POST	`/auth/login`	Log in with username and favorite book
GET, PATCH	`/auth/preferences`	Read or update user preferences
POST	`/chat`	Chat turn
POST	`/chat/stream`	Chat turn streamed over SSE
POST, GET	`/sessions`	Create or list chat sessions
GET	`/sessions/{session_id}/history`	Session messages
PATCH, DELETE	`/sessions/{session_id}`	Update or delete a session
GET	`/api/memories`	List memories
DELETE	`/api/memories/{memory_id}`	Forget a memory
GET	`/api/memory-stats`	Memory statistics
POST	`/api/memorize`	Store a memory manually
POST	`/api/feedback`	Thumbs up or down on a reply
GET	`/api/search-archive`	Search the context archive
GET	`/api/models`	List chat models
POST	`/api/generate/image, /video, /voice`	Media generation
GET	`/api/generate/assets`	List generated assets
DELETE	`/api/generate/assets/{asset_id}`	Delete an asset
POST, GET	`/api/tasks`	Create or list tasks
PATCH, DELETE	`/api/tasks/{task_id}`	Update or delete a task
POST	`/api/contact-feedback`	Send feedback
GET	`/mcp/memory-skills`	MCP memory skill catalog
GET	`/health`	Health check

Check the backend is up. Open http://localhost:8000/health.
Tables are missing or the app reports schema errors. Apply migrations: docker compose exec backend alembic upgrade head.
Qwen calls fail with an international-region key. Set DASHSCOPE_BASE_URL to https://dashscope-intl.aliyuncs.com/api/v1. Leave it blank for the SDK default (Beijing).
Using the alias key name. The backend also accepts QWEN_DASHSCOPE_API if DASHSCOPE_API_KEY is unset.
HTTP 429 from chat or media. You reached a per-user quota: 20 messages, 5 images, 5 videos or 5 voice generations.
Lost data after an update. Never run docker compose down -v. It deletes the pgdata volume. Update with docker compose down && docker compose up -d --build.