base on A modern, open-source, self-hosted knowledge management and note-taking platform designed for privacy-conscious users and organizations. # Memos <img align="right" height="96px" src="https://www.usememos.com/logo-rounded.png" alt="Memos" /> A modern, open-source, self-hosted knowledge management and note-taking platform designed for privacy-conscious users and organizations. Memos provides a lightweight yet powerful solution for capturing, organizing, and sharing thoughts with comprehensive Markdown support and cross-platform accessibility. <div align="center"> [](https://www.usememos.com) [](https://www.usememos.com/docs) [](https://demo.usememos.com/) [](https://www.usememos.com/blog) [](https://hub.docker.com/r/neosmemo/memos) [](https://hub.docker.com/r/neosmemo/memos) [](https://discord.gg/tfPJa4UmAv) </div>  ## Table of Contents - [Overview](#overview) - [Key Features](#key-features) - [Quick Start](#quick-start) - [Installation Methods](#installation-methods) - [Development Setup](#development-setup) - [Contributing](#contributing) - [License](#license) ## Overview Memos is a lightweight, self-hosted alternative to cloud-based note-taking services. Built with privacy and performance in mind, it offers a comprehensive platform for personal knowledge management without compromising data ownership or security. ## Key Features ### Data Privacy and Security - **Complete Data Ownership**: All application data is stored locally in your chosen database - **Self-Hosted Architecture**: Full control over your data infrastructure and access policies - **No External Dependencies**: Runtime operations require no third-party services or cloud connections ### Content Creation and Management - **Plain Text Efficiency**: Streamlined text input with immediate save functionality - **Advanced Markdown Support**: Comprehensive Markdown rendering with syntax highlighting - **Rich Media Integration**: Support for images, links, and embedded content ### Technical Excellence - **High-Performance Backend**: Built with Go for optimal resource utilization and scalability - **Modern Frontend**: React.js-based user interface with responsive design - **Lightweight Deployment**: Minimal system requirements with efficient resource consumption - **Cross-Platform Compatibility**: Supports Linux, macOS, Windows, and containerized environments ### Customization and Extensibility - **Configurable Interface**: Customizable server branding, themes, and user interface elements - **API-First Design**: RESTful API with comprehensive documentation for third-party integrations - **Multi-Database Support**: Compatible with SQLite, PostgreSQL, and MySQL databases ### Cost-Effective Solution - **Open Source License**: MIT licensed with full source code availability - **Zero Licensing Costs**: No subscription fees, usage limits, or premium tiers - **Community-Driven Development**: Active community contribution and transparent development process ## Quick Start ### Prerequisites - Docker or Docker Compose installed on your system - Minimum 512MB RAM and 1GB available disk space ### Docker Deployment Deploy Memos in production mode using Docker: ```bash # Create data directory mkdir -p ~/.memos # Run Memos container docker run -d \ --name memos \ --restart unless-stopped \ -p 5230:5230 \ -v ~/.memos:/var/opt/memos \ neosmemo/memos:stable ``` Access the application at `http://localhost:5230` and complete the initial setup process. ### Docker Compose Deployment For advanced configurations, use Docker Compose: ```yaml # docker-compose.yml version: "3.8" services: memos: image: neosmemo/memos:stable container_name: memos restart: unless-stopped ports: - "5230:5230" volumes: - ./data:/var/opt/memos environment: - MEMOS_MODE=prod - MEMOS_PORT=5230 ``` Deploy with: ```bash docker-compose up -d ``` > **Note**: The data directory (`~/.memos/` or `./data/`) stores all application data including the database, uploaded files, and configuration. Ensure this directory is included in your backup strategy. > > **Platform Compatibility**: The above commands are optimized for Unix-like systems (Linux, macOS). For Windows deployments, please refer to the [Windows-specific documentation](https://www.usememos.com/docs/install/container-install#docker-on-windows). ## Installation Methods Memos supports multiple installation approaches to accommodate different deployment scenarios: ### Container Deployment - **Docker Hub**: Official images available at `neosmemo/memos` - **GitHub Container Registry**: Alternative registry with the same image versions - **Kubernetes**: Helm charts and YAML manifests for cluster deployments ### Binary Installation - **Pre-compiled Binaries**: Available for Linux, macOS, and Windows on the releases page ### Source Installation - **Go Build**: Compile from source using Go 1.24 or later - **Development Mode**: Local development setup with hot reloading For detailed installation instructions, refer to the [comprehensive installation guide](https://www.usememos.com/docs/install). ## Development Setup ### Prerequisites - Go 1.24 or later - Node.js 22+ and pnpm - Git for version control ### Backend Development ```bash # Clone the repository git clone https://github.com/usememos/memos.git cd memos # Install Go dependencies go mod download # Run the backend server go run ./bin/memos/main.go --mode dev --port 8081 ``` ### Frontend Development ```bash # Navigate to web directory cd web # Install dependencies pnpm install # Start development server pnpm dev ``` The development servers will be available at: - Backend API: `http://localhost:8081` - Frontend: `http://localhost:3001` ## Contributing Memos is an open-source project that welcomes contributions from developers, designers, and users worldwide. We maintain a collaborative and inclusive development environment that values quality, innovation, and community feedback. ### Ways to Contribute - **Code Contributions**: Bug fixes, feature implementations, and performance improvements - **Documentation**: API documentation, user guides, and technical specifications - **Testing**: Quality assurance, test case development, and bug reporting - **Localization**: Translation support for multiple languages and regions - **Community Support**: Helping users on Discord, GitHub discussions, and forums ## License Memos is released under the MIT License, providing maximum flexibility for both personal and commercial use. This license allows for: - **Commercial Use**: Deploy Memos in commercial environments without licensing fees - **Modification**: Adapt and customize the codebase for specific requirements - **Distribution**: Share modified versions while maintaining license attribution - **Private Use**: Use Memos internally without disclosure requirements See the [LICENSE](./LICENSE) file for complete licensing terms. ## Project Status > **Development Status**: Memos is actively maintained and under continuous development. While the core functionality is stable and production-ready, users should expect regular updates, feature additions, and potential breaking changes as the project evolves. > > **Version Compatibility**: We maintain backward compatibility for data storage and API interfaces where possible. Migration guides are provided for major version transitions. ## Support and Community - **Documentation**: [Official Documentation](https://www.usememos.com/docs) - **Community Chat**: [Discord Server](https://discord.gg/tfPJa4UmAv) - **Issue Tracking**: [GitHub Issues](https://github.com/usememos/memos/issues) - **Discussions**: [GitHub Discussions](https://github.com/usememos/memos/discussions) [](https://star-history.com/#usememos/memos&Date) ", Assign "at most 3 tags" to the expected json: {"id":"1854","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"