[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-3012":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":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":37,"readmeContent":38,"aiSummary":39,"trendingCount":16,"starSnapshotCount":16,"syncStatus":40,"lastSyncTime":41,"discoverSource":42},3012,"arkon","nduckmink\u002Farkon","nduckmink","Arkon: Enterprise AI Knowledge Hub & MCP Server. Self-hosted knowledge base for teams to manage RAG contexts, access policies, and AI skills. Connect Claude and other LLMs via Model Context Protocol (MCP) for automated, secure organizational knowledge integration.","",null,"Python",976,230,15,3,0,24,59,352,72,11.09,"Other",false,"main",true,[27,28,29,30,31,32,33,34,35,36],"ai","claude","knowledge-base","knowledge-management","knowledge-sharing","knowledgebase","llm-wiki","llm-wiki-knowledge-base","llm-wiki-organization-knowledge-base","wiki-llm","2026-06-12 02:00:45","# Arkon - The Open-Source Enterprise AI Knowledge Hub & MCP Server\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-PolyForm_Internal_Use_1.0.0-blue.svg\" alt=\"License\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnduckmink\u002Farkon\u002Fstargazers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fnduckmink\u002Farkon.svg\" alt=\"GitHub Stars\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.docker.com\u002F\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocker-Ready-blue.svg\" alt=\"Docker\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Farkon.png\" alt=\"Arkon\" width=\"720\">\n\u003C\u002Fp>\n\n**Arkon** is a self-hosted, enterprise-grade knowledge management layer that bridges organizational data and AI clients. It runs as a centralized **MCP Server** (Model Context Protocol), compiling your SOPs, policies, and internal docs into a structured, traceable knowledge wiki - then serving that wiki to Claude and other LLMs through a single permission-scoped endpoint.\n\n## 🚀 Why Arkon?\n\nIn most organizations, AI adoption is fragmented. Employees copy-paste documents into chatbots, producing inconsistent context, security risks, and duplicated work.\n\n**Arkon treats AI as a managed organizational resource.** Every employee gets the right context, automatically and securely - filtered by their department, project membership, and role.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fhow-arkon-works.png\" alt=\"How Arkon Works\" width=\"720\">\n\u003C\u002Fp>\n\n---\n\n## ✨ Key Features\n\n### 🧠 Intelligent Knowledge Wiki - the MRP Pipeline\nUnlike a vector database that just chunks and indexes, Arkon's **MRP pipeline** (**M**ap → **R**educe → **P**lan-review → **R**efine → **V**erify → Commit) actually compiles documents into a coherent wiki of interlinked pages.\n- **Plan review before write:** every ingestion produces a human-reviewable plan listing which wiki pages will be created or updated. Editors can regenerate the plan with feedback before any page is written.\n- **Page merge instead of overwrite:** when a new source touches an existing wiki page, content is LLM-merged so prior knowledge is never lost.\n- **Traceable claims:** every page records the source documents it was compiled from.\n- **Image-aware:** vision captions are baked into source text before compilation, so wiki pages reference the right images in the right places.\n- **Resumable:** drafts persist mid-pipeline; a crashed run resumes without re-doing the expensive LLM work.\n\n### 📚 Wiki Browser & Knowledge Graph\n- Three-panel layout: page tree, content, backlinks & outlinks.\n- Full-text + semantic (pgvector) search.\n- Interactive knowledge graph visualization (per-scope or global).\n- Wikilink-style cross-references between pages.\n- Version history and rollback on every page.\n- Draft proposal → editor review → approval workflow.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Farkon-wiki-ui.png\" alt=\"Arkon Wiki Browser UI — three-panel knowledge base with page tree, content viewer, and knowledge graph\" width=\"720\">\n\u003C\u002Fp>\n\n### 🏢 Workspaces (Department & Project Scopes)\nCross-functional contexts with their own scoped wiki, document set, and member roster.\n- **Department-level isolation** for HR, Legal, Engineering, etc.\n- **Project workspaces** for cross-functional initiatives or clients.\n- **Hard scope enforcement:** members only see knowledge from their assigned scopes - at the API, MCP, and search layers.\n\n### 🛂 Fine-Grained RBAC\nRole-based access control at department + workspace level.\n- Built-in roles: **Viewer · Contributor · Editor · Admin** (and admin-defined custom roles).\n- Granular permissions (`doc:read:own_dept`, `wiki:edit:all`, `org:settings:manage`, ...).\n- **Audit log** for every privileged action - settings changes, plan approvals, role updates.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fpermission-and-scope.png\" alt=\"Arkon RBAC permission model — department and project scope isolation with role-based access control\" width=\"720\">\n\u003C\u002Fp>\n\n### 🔌 MCP Server for Claude & Other AI Clients\nEmployees connect Claude Desktop or Claude.ai to Arkon via **OAuth 2.1 + PKCE** — just add the server URL and sign in through the browser. No manual token copying required. The MCP server exposes:\n- **Wiki tools** - `search_wiki`, `read_wiki_page`, `list_wiki_pages`, `read_wiki_index`.\n- **Source drill-down** - `get_source`, `get_source_outline`, `get_source_pages`, `list_sources`.\n- **Edit workflow** - `propose_wiki_edit`, `edit_wiki_page`, `list_pending_drafts`, `review_draft`, `approve_draft`, `reject_draft`.\n- **Discovery** - `list_knowledge_types`, `get_knowledge_type_docs`.\n\nAll tools enforce per-token scope (department, knowledge type, source list).\n\n### 🧰 AI Skills Distribution\nUpload custom agent packages once and distribute them across the org.\n- Versioned skill packages (.zip with `SKILL.md`).\n- Department-scoped visibility.\n- Contribution workflow for end-user updates.\n\n### 🤖 Pluggable AI Providers\nCatalog-driven selection - admins pick from a curated list with context window, cost, and capability metadata on display.\n- **LLM:** Anthropic Claude (Opus \u002F Sonnet \u002F Haiku 4.x), Google Gemini (3.x Pro \u002F Flash \u002F Flash-Lite, 2.5), OpenAI (GPT-5.x, GPT-4.x).\n- **Embedding:** Google `gemini-embedding-*`, OpenAI `text-embedding-3-*` - switchable with online re-embed migration (active model atomically flipped on completion, no zero-result search window).\n- **Vision:** Google Gemini Flash, OpenAI GPT-4o family.\n\n### 🔒 Privacy & Security First\n- **Self-hosted.** Deploy on-prem or in your private cloud via Docker.\n- **No telemetry.** Outbound traffic goes only to the AI provider you choose.\n- **Encrypted at rest.** API keys stored with Fernet encryption in PostgreSQL.\n\n---\n\n## 🛠️ Tech Stack\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Farkon-architecture.png\" alt=\"Arkon Architecture\" width=\"720\">\n\u003C\u002Fp>\n\n- **Backend:** FastAPI · PostgreSQL + pgvector · Redis (arq workers) · MinIO\n- **Frontend:** Next.js · Tailwind CSS\n- **AI integration:** Model Context Protocol via FastMCP\n- **Document parsing:** PDF, DOCX, DOC, plain text, URLs, embedded images\n\n---\n\n## 💻 Server Requirements\n\nArkon runs **7 Docker containers** (PostgreSQL + pgvector, Redis, MinIO, FastAPI API, 2 ARQ workers, Next.js frontend). The table below provides recommended configurations based on team size:\n\n| | **Starter** | **Team** | **Enterprise** |\n|---|:---:|:---:|:---:|\n| **Team size** | 1 – 20 | 20 – 100 | 100+ |\n| **vCPU** | 2 cores | 4 cores | 8+ cores |\n| **RAM** | 4 GB | 8 GB | 16+ GB |\n| **Storage** | 40 GB SSD | 100 GB SSD | 250+ GB NVMe SSD |\n| **OS** | Ubuntu 22.04+ \u002F Debian 12+ | Ubuntu 22.04+ \u002F Debian 12+ | Ubuntu 22.04+ \u002F Debian 12+ |\n| **Use case** | Evaluation \u002F small teams | Departmental deployment | Organization-wide rollout |\n\n> [!NOTE]\n> - **RAM** is the primary bottleneck — the MRP pipeline workers load large LLM context windows into memory during wiki compilation.\n> - **Storage** scales with your document corpus — pgvector indexes, MinIO file storage, and PostgreSQL WAL logs are the main consumers.\n> - All AI inference happens externally (Anthropic \u002F Google \u002F OpenAI APIs), so **GPU is not required**.\n> - A reverse proxy (Nginx \u002F Caddy) with SSL is recommended for production. See [Setup Guide](docs\u002FSETUP.md).\n\n---\n\n## 🚦 Quick Start (Docker)\n\n> [!NOTE]\n> **Arkon is built for teams, not individuals.** If you're looking for a personal knowledge setup, [Obsidian](https:\u002F\u002Fobsidian.md) + Claude Skills is a much simpler fit.\n>\n> **Not a tech person?** Skip the self-hosting hassle — reach out for a **free guided demo** tailored for your team. No config, no Docker, just a walkthrough of what Arkon can do for your organization.\n\n**Prerequisites:** Docker & Docker Compose, plus an API key from your preferred AI provider (Anthropic, Google, or OpenAI).\n\n1. **Clone the repository:**\n   ```shell\n   git clone https:\u002F\u002Fgithub.com\u002Fnduckmink\u002Farkon.git\n   cd arkon\n   ```\n\n2. **Configure environment:**\n   ```shell\n   cp .env.docker.example .env.docker\n   # Edit .env.docker - set SECRET_KEY, admin credentials, and Postgres\u002FMinIO secrets\n   ```\n\n3. **Launch:**\n   ```shell\n   docker compose --env-file .env.docker up -d --build\n   ```\n\n4. Access the portal at `http:\u002F\u002Flocalhost:3119`, sign in as admin, then go to **Settings** to pick your embedding \u002F LLM \u002F vision models and paste API keys.\n\n→ See [Setup Guide](docs\u002FSETUP.md) for development mode and the full env reference.\n\n---\n\n## 🔗 Connecting Claude\n\nIn **Claude Desktop** or **Claude.ai → Settings → Connectors**, add a custom connector:\n\n- **Name:** `Arkon`\n- **URL:** `https:\u002F\u002Fyour-arkon-server\u002Fmcp`\n\nClick **Connect** → a browser window opens with the Arkon login form → sign in with your Arkon credentials → done. Arkon uses OAuth 2.1 + PKCE so no manual token setup is required.\n\n**To make Claude consistently use Arkon**, add this to Claude's **Custom Instructions** (Settings → Custom Instructions):\n\n```\nWhenever answering questions related to the company — its processes, products,\npeople, departments, policies, or projects — always search Arkon first using\nthe search_wiki tool before relying on general knowledge.\n```\n\nFor stronger enforcement, create a **Project** in Claude Desktop, attach Arkon as a connector, and paste the same text as Project Instructions.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Farkon-in-use-of-claude.png\" alt=\"Arkon in use with Claude Desktop\" width=\"720\">\n\u003C\u002Fp>\n\n→ See [MCP & Claude](docs\u002FMCP.md) for the complete tool reference.\n\n---\n\n## 🗺️ Roadmap\n\n- [x] **MRP Pipeline** - deterministic compilation with plan review, page merge, and resume-on-crash.\n- [x] **MCP Server** - scoped wiki + source + draft tools.\n- [x] **Workspaces** - department isolation + project scopes with RBAC.\n- [x] **Wiki draft & revision workflow** - propose, review, approve, rollback.\n- [x] **AI Skills** - versioned, department-scoped agent packages.\n- [x] **Catalog-driven model selection** - LLM, embedding, and vision picked from a curated list with cost\u002Fcontext-window metadata.\n- [x] **Online embedding migration** - atomic re-embed with no search downtime.\n- [x] **Audit log** - privileged actions tracked.\n- [ ] **Rich media ingestion** - bulk folder upload with images, videos, and Excel\u002Fspreadsheet parsing baked into the MRP pipeline.\n- [x] **Usage analytics dashboard**\n- [ ] **External data import** - connectors for SharePoint, Google Drive, Notion, and other common org data sources.\n- [ ] **Arkon CLI** - one-command setup for employees.\n- [ ] **Notification system** - for draft reviews and plan approvals.\n\n---\n\n## ⭐ Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=nduckmink\u002Farkon&type=Date)](https:\u002F\u002Fstar-history.com\u002F#nduckmink\u002Farkon&Date)\n\n---\n\n## 📄 License\n\nArkon is licensed under the [PolyForm Internal Use License 1.0.0](LICENSE). Free for internal business operations; you may not offer Arkon as a service to third parties.\n\nFor enterprise support or custom integrations, please contact the maintainers.\n\n---\n\n**Keywords:** *Enterprise AI, Model Context Protocol, MCP Server, Knowledge Management System, Self-hosted RAG, AI Knowledge Base, Claude MCP, LLM Context Management, Open Source Wiki.*\n\n---\n\n## 📬 Contact\n\n**Main Author**\nMinh Nguyen (Nguyễn Đức Minh) — Vietnam (GMT+7) · Fluent English\n✉️ [duckmink.bitsness@gmail.com](mailto:duckmink.bitsness@gmail.com)\n\n**Company**\nBITSNESS TECHNOLOGY AND SOLUTIONS COMPANY LIMITED\n✉️ [bitsness.ad@bitsness.vn](mailto:bitsness.ad@bitsness.vn)\n\nFor enterprise inquiries, demo requests, or custom integrations — email us directly.\n","Arkon 是一个企业级的AI知识中心和MCP服务器，用于团队管理和集成组织内的RAG上下文、访问策略及AI技能。其核心功能包括通过Model Context Protocol (MCP)协议安全地连接Claude等大语言模型，实现自动化的企业知识整合；采用MRP管道（映射-归约-计划审查-精炼-验证-提交）将文档编译成结构化、可追溯的知识维基，并支持图像识别与处理。此外，Arkon提供了一个具备全文搜索、语义搜索、交互式知识图谱等功能的三面板布局维基浏览器界面。适用于需要加强内部文档管理、促进跨部门知识共享以及确保AI应用时信息安全的企业场景。",2,"2026-06-11 02:52:08","CREATED_QUERY"]