Repository: usememos/memos

Stars: 58951

CLAUDE.md Copy Chapter

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

See AGENTS.md for full architecture, workflows, conventions, and patterns.

README.md Copy Chapter

<div align="center">
<p>
<span>Featured Sponsor:</span>
<a href="https://go.warp.dev/memos" target="_blank" rel="noopener">
<b>Warp</b>
<span>— The AI-powered terminal built for speed and collaboration</span>
</a>
</p>
<a href="https://go.warp.dev/memos" target="_blank" rel="noopener">
<img alt="Warp sponsorship" height="196" src="https://raw.githubusercontent.com/warpdotdev/brand-assets/refs/heads/main/Github/Sponsor/Warp-Github-LG-03.png">
</a>
</div>

Memos

<img align="right" height="96px" src="https://raw.githubusercontent.com/usememos/.github/refs/heads/main/assets/logo-rounded.png" alt="Memos" />

Open-source, self-hosted note-taking tool built for quick capture. Markdown-native, lightweight, and fully yours.


<img src="https://raw.githubusercontent.com/usememos/.github/refs/heads/main/assets/demo.png" alt="Memos Demo Screenshot" height="512" />

💎 Featured Sponsors Copy Section

Warp — The AI-powered terminal built for speed and collaboration

<a href="https://go.warp.dev/memos" target="_blank" rel="noopener">
<img src="https://raw.githubusercontent.com/warpdotdev/brand-assets/refs/heads/main/Logos/Warp-Wordmark-Black.png" alt="Warp - The AI-powered terminal built for speed and collaboration" height="44" />
</a>

<p></p>

TestMu AI - The world’s first full-stack Agentic AI Quality Engineering platform

<a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=memos" target="_blank" rel="noopener">
<img src="https://usememos.com/sponsors/testmu.svg" alt="TestMu AI" height="36" />
</a>

<p></p>

SSD Nodes - Affordable VPS hosting for self-hosters

<a href="https://ssdnodes.com/?utm_source=memos&utm_medium=sponsor" target="_blank" rel="noopener">
<img src="https://usememos.com/sponsors/ssd-nodes.svg" alt="SSD Nodes" height="72" />
</a>

Features Copy Chapter

- Instant Capture — Timeline-first UI. Open, write, done — no folders to navigate.
- Total Data Ownership — Self-hosted on your infrastructure. Notes stored in Markdown, always portable. Zero telemetry.
- Radical Simplicity — Single Go binary, ~20MB Docker image. One command to deploy with SQLite, MySQL, or PostgreSQL.
- Open & Extensible — MIT-licensed with full REST and gRPC APIs for integration.

Quick Start Copy Chapter

Docker (Recommended) Copy Section

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 Copy Section

curl -fsSL https://raw.githubusercontent.com/usememos/memos/main/scripts/install.sh | sh

Try the Live Demo Copy Section

Don't want to install yet? Try our live demo first!

Other Installation Methods Copy Section

- Docker Compose - Recommended for production deployments
- Pre-built Binaries - Available for Linux, macOS, and Windows
- Kubernetes - Helm charts and manifests available
- Build from Source - For development and customization

See our installation guide for detailed instructions.

Contributing Copy Chapter

Contributions are welcome — bug reports, feature suggestions, pull requests, documentation, and translations.

- Report bugs
- Suggest features
- Submit pull requests
- Improve documentation
- Help with translations

Sponsors Copy Chapter

Love Memos? Sponsor us on GitHub to help keep the project growing!

Star History Copy Chapter


License Copy Chapter

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

<a href="https://vercel.com/oss">
<img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge.svg" />
</a>