Affected by 
README
¶
✨ Featured Sponsor: CodeRabbit — Cut code review time & bugs in half, instantly.
Memos
Memos is an open-source, self-hosted note-taking app built for quick capture. It is Markdown-native, lightweight, and keeps your data under your control.
Features
- Capture quickly — A timeline-first interface keeps note-taking simple: open, write, and move on.
- Own your data — Self-host Memos on your infrastructure with no telemetry.
- Deploy anywhere — Run a single Go binary or Docker container with SQLite, MySQL, or PostgreSQL.
- Integrate freely — Build on the REST and gRPC APIs or adapt the MIT-licensed source to your needs.
Quick Start
Want to explore Memos first? Open the live demo.
Docker (Recommended)
docker run -d \
--name memos \
-p 5230:5230 \
-v ~/.memos:/var/opt/memos \
neosmemo/memos:stable
Open http://localhost:5230 and start writing.
Native Binary
curl -fsSL https://raw.githubusercontent.com/usememos/memos/main/scripts/install.sh | sh
Other Installation Methods
- Docker Compose — Recommended for production deployments.
- Kubernetes — Helm charts and manifests are available.
- Build from source — Best for development and customization.
See the deployment guide for detailed instructions.
Web Clipper
Save pages, selected text, and images directly to your Memos instance with the official Memos Web Clipper. The extension is available for Chrome and Firefox, and lets you review each clip, choose its visibility, and customize its Markdown format before saving.
Contributing
Contributions of all kinds are welcome, including bug reports, feature suggestions, pull requests, documentation, and translations.
Sponsors
- CodeRabbit — Cut code review time and bugs in half
- SSD Nodes — Affordable VPS hosting for self-hosters
Love Memos? Sponsor us on GitHub to help keep the project growing!
License
Memos is open-source software licensed under the MIT License. See our Privacy Policy for details on data handling.
Website • Documentation • Demo • Discord • X/Twitter
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
memos
command
|
|
|
internal
|
|
|
ai/audio
Package audio provides audio container/codec helpers for AI providers.
|
Package audio provides audio container/codec helpers for AI providers. |
|
ai/audiollm
Package audiollm defines the multimodal-audio capability for AI providers.
|
Package audiollm defines the multimodal-audio capability for AI providers. |
|
ai/audiollm/gemini
Package gemini implements audiollm.Model against the Gemini generateContent endpoint.
|
Package gemini implements audiollm.Model against the Gemini generateContent endpoint. |
|
ai/stt
Package stt defines the speech-to-text capability for AI providers.
|
Package stt defines the speech-to-text capability for AI providers. |
|
ai/stt/openai
Package openai implements stt.Transcriber against the OpenAI /audio/transcriptions endpoint (and any compatible third-party endpoint such as Groq Whisper, faster-whisper self-hosted, or Azure Whisper).
|
Package openai implements stt.Transcriber against the OpenAI /audio/transcriptions endpoint (and any compatible third-party endpoint such as Groq Whisper, faster-whisper self-hosted, or Azure Whisper). |
|
email
Package email provides SMTP email sending functionality for self-hosted Memos instances.
|
Package email provides SMTP email sending functionality for self-hosted Memos instances. |
|
idp/oauth2
Package oauth2 implements the OAuth2 identity provider integration.
|
Package oauth2 implements the OAuth2 identity provider integration. |
|
scheduler
Package scheduler provides a GitHub Actions-inspired cron job scheduler.
|
Package scheduler provides a GitHub Actions-inspired cron job scheduler. |
|
gen/api/v1
Package apiv1 is a reverse proxy.
|
Package apiv1 is a reverse proxy. |
|
auth
Package auth provides authentication and authorization for the Memos server.
|
Package auth provides authentication and authorization for the Memos server. |
|
db/sqlite
Package sqlite provides SQLite driver implementation with custom functions.
|
Package sqlite provides SQLite driver implementation with custom functions. |