[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72738":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":46,"readmeContent":47,"aiSummary":48,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":49,"discoverSource":50},72738,"NoteDiscovery","gamosoft\u002FNoteDiscovery","gamosoft","Your Self-Hosted Knowledge Base","https:\u002F\u002Fwww.notediscovery.com",null,"JavaScript",2543,211,13,4,0,2,11,51,6,28.98,"MIT License",false,"main",true,[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45],"alternative","docker","evernote","fastapi","free","hosted","knowledge-base","markdown","note","note-taking","notion","obsidian","onenote","open-source","privacy","python","second-brain","self-hosted","zettelkasten","2026-06-12 02:03:07","# 📝 NoteDiscovery\n\n![GitHub Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fgamosoft\u002Fnotediscovery?style=flat)\n![Build](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fgamosoft\u002Fnotediscovery\u002Fdocker-publish.yml)\n![Latest Version](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Ftag\u002Fgamosoft\u002Fnotediscovery)\n![License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fgamosoft\u002Fnotediscovery)\n\n\n\n> Your Self-Hosted Knowledge Base\n\n## What is NoteDiscovery?\n\nNoteDiscovery is a **lightweight, self-hosted note-taking application** that puts you in complete control of your knowledge base. Write, organize, and discover your notes with a beautiful, modern interface—all running on your own server.\n\n![Note Discovery](docs\u002Fcarousel-1.jpg)\n\n## 🎯 Who is it for?\n\n- **Privacy-conscious users** who want complete control over their data\n- **Developers** who prefer markdown and local file storage\n- **Knowledge workers** building a personal wiki or second brain\n- **Teams** looking for a self-hosted alternative to commercial apps\n- **Anyone** who values simplicity, speed, and ownership\n\n---\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.notediscovery.com\">\u003Cimg src=\"docs\u002Fwebsite-button.svg\" alt=\"Official Website\">\u003C\u002Fa>\n    \n  \u003Ca href=\"https:\u002F\u002Fgamosoft-notediscovery-demo.hf.space\">\u003Cimg src=\"docs\u002Fdemo-button.svg\" alt=\"Try Live Demo\">\u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.pikapods.com\u002Fpods?run=notediscovery\">\u003Cimg src=\"https:\u002F\u002Fwww.pikapods.com\u002Fstatic\u002Frun-button.svg\" alt=\"Run on PikaPods\">\u003C\u002Fa>\n    \n  \u003Ca href=\"https:\u002F\u002Fko-fi.com\u002Fgamosoft\">\u003Cimg src=\"https:\u002F\u002Fko-fi.com\u002Fimg\u002Fgithubbutton_sm.svg\" alt=\"Buy Me a Coffee at ko-fi.com\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n## ✨ Why NoteDiscovery?\n\n### vs. Commercial Apps (Notion, Evernote, Obsidian Sync)\n\n| Feature | NoteDiscovery | Commercial Apps |\n|---------|---------------|-----------------|\n| **Cost** | 100% Free | $xxx\u002Fmonth\u002Fyear |\n| **Privacy** | Your server, your data | Their servers, their terms |\n| **Speed** | Lightning fast | Depends on internet |\n| **Offline** | Always works | Limited or requires sync |\n| **Customization** | Full control | Limited options |\n| **No Lock-in** | Plain markdown files | Proprietary formats |\n\n### Key Benefits\n\n- 🔒 **Total Privacy** - Your notes never leave your server\n- 🔐 **Optional Authentication** - Simple password protection for self-hosted deployments\n- 💰 **Zero Cost** - No subscriptions, no hidden fees\n- 🚀 **Fast & Lightweight** - Instant search and navigation\n- 🎨 **Beautiful Themes** - Multiple themes, easy to customize\n- 🔌 **Extensible** - Plugin system for custom features\n- 📱 **Responsive** - Works on desktop, tablet, and mobile\n- 📂 **Simple Storage** - Plain markdown files in folders\n- 🧮 **Math Support** - LaTeX\u002FMathJax for beautiful equations\n- 📄 **HTML Export & Print** - Export notes as standalone HTML or print\n- 🕸️ **Graph View** - Interactive visualization of connected notes\n- ✏️ **Drawing editor** - In-app sketches as `drawing-*.png` next to your notes — see [documentation\u002FDRAWING.md](documentation\u002FDRAWING.md)\n- ⭐ **Favorites** - Star your most-used notes for instant access\n- 📑 **Outline Panel** - Navigate headings with click-to-jump TOC\n- 🤖 **AI Assistant Ready** - MCP integration for Claude, Cursor & more\n\n## 🤖 AI-Powered Note Management\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-Compatible-blueviolet?style=for-the-badge&logo=data:image\u002Fsvg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCI+PHBhdGggZD0iTTEyIDJhMTAgMTAgMCAxIDAgMTAgMTBIMTJWMnoiLz48cGF0aCBkPSJNMjEuMTggOC44MmMtLjI4LS40LS43Mi0uODItMS4xOC0uODJoLTNjLS40NiAwLS45LjQyLTEuMTguODItLjI4LjQtLjMyLjk4LS4xMiAxLjQybDEuNSAzYy4yLjQ0LjY2LjcgMS4xMi43aDEuMzZjLjQ2IDAgLjkyLS4yNiAxLjEyLS43bDEuNS0zYy4yLS40NC4xNi0xLjAyLS4xMi0xLjQyeiIvPjwvc3ZnPg==\" alt=\"MCP Compatible\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWorks%20with-Claude-orange?style=for-the-badge\" alt=\"Works with Claude\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWorks%20with-Cursor-blue?style=for-the-badge\" alt=\"Works with Cursor\">\n\u003C\u002Fp>\n\nNoteDiscovery includes a built-in **Model Context Protocol (MCP)** server, letting AI assistants directly interact with your notes:\n\n| What AI Can Do | Example |\n|----------------|---------|\n| 🔍 **Search & Discover** | *\"Find all my notes about Docker deployment\"* |\n| 📝 **Create & Edit** | *\"Create a meeting notes template for tomorrow\"* |\n| 📁 **Organize** | *\"Move all project notes to the archive folder\"* |\n| 🏷️ **Tag & Categorize** | *\"List all notes tagged with #urgent\"* |\n| 📊 **Explore Connections** | *\"Show me the knowledge graph of my notes\"* |\n| ✍️ **Append Ideas** | *\"Add this thought to my daily journal\"* |\n\n**One-line setup** for Cursor, Claude Desktop, and other MCP-compatible tools:\n\n```json\n{\n  \"mcpServers\": {\n    \"notediscovery\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"--rm\", \"-i\", \"-e\", \"NOTEDISCOVERY_URL=http:\u002F\u002Fhost.docker.internal:8000\", \"ghcr.io\u002Fgamosoft\u002Fnotediscovery:latest\", \"python\", \"-m\", \"mcp_server\"]\n    }\n  }\n}\n```\n\n> 💡 **See [MCP.md](documentation\u002FMCP.md)** for complete setup instructions and all available tools.\n\n## 🚀 Quick Start\n\n### Quick Setup\n\n**Linux\u002FmacOS:**\n```bash\nmkdir -p notediscovery\u002Fdata && cd notediscovery\ndocker run -d --name notediscovery -p 8000:8000 \\\n  -v $(pwd)\u002Fdata:\u002Fapp\u002Fdata \\\n  ghcr.io\u002Fgamosoft\u002Fnotediscovery:latest\n```\n\n**Windows (PowerShell):**\n```powershell\nmkdir notediscovery\\data; cd notediscovery\ndocker run -d --name notediscovery -p 8000:8000 `\n  -v ${PWD}\u002Fdata:\u002Fapp\u002Fdata `\n  ghcr.io\u002Fgamosoft\u002Fnotediscovery:latest\n```\n\nOpen **http:\u002F\u002Flocalhost:8000** — done! 🎉  \n\n\n> 💡 Your notes are saved in `.\u002Fdata\u002F`. Themes, plugins, locales and default configuration values are included in the image.\n\n### Using Docker Compose\n\nTwo docker-compose files are provided:\n\n| File | Use Case |\n|------|----------|\n| `docker-compose.ghcr.yml` | **Recommended** - Uses pre-built image from GitHub Container Registry |\n| `docker-compose.yml` | For development - Builds from local source |\n\n**Option 1: Pre-built image (fastest)**\n\nLinux\u002FmacOS:\n```bash\nmkdir -p notediscovery\u002Fdata && cd notediscovery\ncurl -O https:\u002F\u002Fraw.githubusercontent.com\u002Fgamosoft\u002Fnotediscovery\u002Fmain\u002Fdocker-compose.ghcr.yml\ndocker-compose -f docker-compose.ghcr.yml up -d\n```\n\nWindows (PowerShell):\n```powershell\nmkdir notediscovery\\data; cd notediscovery\nInvoke-WebRequest -Uri https:\u002F\u002Fraw.githubusercontent.com\u002Fgamosoft\u002Fnotediscovery\u002Fmain\u002Fdocker-compose.ghcr.yml -OutFile docker-compose.ghcr.yml\ndocker-compose -f docker-compose.ghcr.yml up -d\n```\n\n**Option 2: Build from source (for development)**\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fgamosoft\u002Fnotediscovery.git\ncd notediscovery\ndocker-compose up -d\n```\n\nSee [Advanced Docker Setup](#advanced-docker-setup) for volume details.\n\n\n### Running Locally (Without Docker)\n\nFor development or if you prefer running directly:\n\n```bash\n# Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002Fgamosoft\u002Fnotediscovery.git\ncd notediscovery\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run the application\npython run.py\n\n# Access at http:\u002F\u002Flocalhost:8000\n```\n\n**Requirements:**\n- Python 3.8 or higher\n- pip (Python package manager)\n\n#### Using Virtual Environments (Recommended for Arch\u002FFedora\u002FUbuntu 23.04+)\n\nModern Linux distributions enforce [PEP 668](https:\u002F\u002Fpeps.python.org\u002Fpep-0668\u002F), which prevents system-wide pip installs. Use a virtual environment instead:\n\n```bash\n# Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002Fgamosoft\u002Fnotediscovery.git\ncd notediscovery\n\n# Create a virtual environment\npython -m venv venv\n\n# Activate it (choose your shell):\nsource venv\u002Fbin\u002Factivate        # Bash\u002FZsh (most Linux distros)\nsource venv\u002Fbin\u002Factivate.fish   # Fish (CachyOS, etc.)\nsource venv\u002Fbin\u002Factivate.csh    # Csh\u002FTcsh\n.\\venv\\Scripts\\activate         # Windows PowerShell\n\n# Install dependencies and run\npip install -r requirements.txt\npython run.py\n```\n\n> ⚠️ **Warning**\n>\n> *You'll need to activate the virtual environment (source venv\u002Fbin\u002Factivate) each time you open a new terminal before running the app*\n\n### Advanced Docker Setup\n\nThe image includes bundled config, themes, plugins, and locales. To customize, you must:\n1. **Map the volume** in your docker-compose or docker run command\n2. **Provide content** - the file\u002Ffolder must exist with valid content (empty = app might break!)\n\n| Volume | Purpose | Bundled? |\n|--------|---------|----------|\n| `data\u002F` | Your notes | ❌ You must create |\n| `config.yaml` | App settings | ✅ Yes |\n| `themes\u002F` | Custom themes | ✅ Yes |\n| `plugins\u002F` | Custom plugins | ✅ Yes |\n| `locales\u002F` | Translations | ✅ Yes |\n\n### Dashboard Integration\n\n\u003Ca href=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fgh\u002Fhomarr-labs\u002Fdashboard-icons@master\u002Fsvg\u002Fnotediscovery.svg\" target=\"_blank\">\n  \u003Cimg src=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fgh\u002Fhomarr-labs\u002Fdashboard-icons@master\u002Fsvg\u002Fnotediscovery.svg\" alt=\"NoteDiscovery Icon\" width=\"64\" height=\"64\">\n\u003C\u002Fa>\n\nAn official icon for NoteDiscovery is now available on [Dashboard Icons](https:\u002F\u002Fdashboardicons.com\u002Ficons\u002Fnotediscovery)!  \nUse it in your self-hosted dashboards like Homepage, Homarr, Dashy, Heimdall, etc...\n\n## 📚 Documentation\n\nWant to learn more?\n\n- 🎨 **[THEMES.md](documentation\u002FTHEMES.md)** - Theme customization and creating custom themes\n- ✨ **[FEATURES.md](documentation\u002FFEATURES.md)** - Complete feature list and keyboard shortcuts\n- ✏️ **[DRAWING.md](documentation\u002FDRAWING.md)** - Built-in drawing editor (`drawing-*.png`), save behavior, and API notes\n- 🏷️ **[TAGS.md](documentation\u002FTAGS.md)** - Organize notes with tags and combined filtering\n- 📋 **[TEMPLATES.md](documentation\u002FTEMPLATES.md)** - Create notes from reusable templates with dynamic placeholders\n- 🧮 **[MATHJAX.md](documentation\u002FMATHJAX.md)** - LaTeX\u002FMath notation examples and syntax reference\n- 📊 **[MERMAID.md](documentation\u002FMERMAID.md)** - Diagram creation with Mermaid (flowcharts, sequence diagrams, and more)\n- 🔌 **[PLUGINS.md](documentation\u002FPLUGINS.md)** - Plugin system and available plugins\n- 🌐 **[API.md](documentation\u002FAPI.md)** - REST API documentation and examples\n- 🤖 **[MCP.md](documentation\u002FMCP.md)** - AI assistant integration (Claude, Cursor, and more)\n- 🔐 **[AUTHENTICATION.md](documentation\u002FAUTHENTICATION.md)** - Enable password protection for your instance\n- 🔧 **[ENVIRONMENT_VARIABLES.md](documentation\u002FENVIRONMENT_VARIABLES.md)** - Configure settings via environment variables\n\n## 🌍 Multiple Languages\n\nNoteDiscovery supports multiple interface languages via JSON locale files in `locales\u002F`. Open **Settings** (gear icon) → **Language** to choose one; the list reflects whatever locales are installed (bundled files, mounts, or your own additions).\n\n**To add your own language:** See the [Contributing Guidelines](CONTRIBUTING.md#-contributing-translations) for instructions on creating translation files.\n\n**Docker users:** Mount your custom locales folder to add or override translations:\n\n```yaml\nvolumes:\n  - .\u002Flocales:\u002Fapp\u002Flocales  # Custom translations\n```\n\n💡 **Pro Tip:** If you clone this repository, you can mount the `documentation\u002F` folder to view these docs inside the app:\n\n```yaml\n# In your docker-compose.yml\nvolumes:\n  - .\u002Fdata:\u002Fapp\u002Fdata              # Your personal notes\n  - .\u002Fdocumentation:\u002Fapp\u002Fdata\u002Fdocs:ro  # Mount docs subfolder inside the data folder (read-only)\n```\n\nThen access them at `http:\u002F\u002Flocalhost:8000` - the docs will appear as a `docs\u002F` folder in the file browser!\n\n## 🤝 Contributing\n\n**Before submitting a pull request**, especially for major changes, please:\n- Read our **[Contributing Guidelines](CONTRIBUTING.md)**\n- Open an issue first to discuss major features or significant changes\n- Ensure your code follows the project's style and philosophy\n\n\n## 🔒 Security Considerations\n\nNoteDiscovery is designed for **self-hosted, private use**. Please keep these security considerations in mind:\n\n### Network Security\n- ⚠️ **Do NOT expose directly to the internet** without additional security measures\n- Run behind a reverse proxy (nginx, Caddy) with HTTPS for production use\n- Keep it on your local network or use a VPN for remote access\n- By default, the app listens on `0.0.0.0:8000` (all network interfaces)\n\n### Authentication\n- **Password protection is DISABLED by default** (default password: `admin`)\n- ⚠️ **ENABLE AUTHENTICATION AND CHANGE THE DEFAULT PASSWORD** if exposing to a network!\n- See **[AUTHENTICATION.md](documentation\u002FAUTHENTICATION.md)** for complete setup instructions\n- To disable auth, set `authentication.enabled: false` in `config.yaml`\n- Perfect for single-user or small team deployments\n- For multi-user setups, consider a reverse proxy with OAuth\u002FSSO\n\n### Data Privacy\n- Your notes are stored as **plain text markdown files** in the `data\u002F` folder\n- No data is sent to external services\n- Regular backups are recommended\n\n### Best Practices\n- Run on `localhost` or a private network only\n- Use Docker for isolation and easier security management\n- Keep your system and dependencies updated\n- Review and audit any plugins you install\n- Set appropriate file permissions on the `data\u002F` directory\n\n**TL;DR**: Perfect for personal use on your local machine or home network. Enable built-in password protection if needed, or use a reverse proxy with authentication if exposing to wider networks.\n\n## 📄 License\n\nMIT License - Free to use, modify, and distribute.\n\n---\n\nMade with ❤️ for the self-hosting community\n","NoteDiscovery 是一个轻量级的自托管笔记应用，让用户完全掌控自己的知识库。它支持使用Markdown编写和组织笔记，并通过美观现代的界面进行展示，所有操作都在用户自己的服务器上完成。其核心技术特点包括支持Docker部署、FastAPI后端以及Python编程语言，保证了应用的速度与灵活性。NoteDiscovery特别适合注重隐私保护的个人用户、偏好本地文件存储的开发者、构建个人维基或第二大脑的知识工作者，以及寻找商业应用替代方案的团队使用。此外，该应用还提供了多种主题选择、插件扩展功能、响应式设计等特性，满足不同场景下的需求。","2026-06-11 03:43:27","high_star"]