[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1418":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":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":14,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":15,"starSnapshotCount":15,"syncStatus":16,"lastSyncTime":28,"discoverSource":29},1418,"wiki-os","Ansub\u002Fwiki-os","Ansub","UI Layer for Karpathy's LLM Wiki","",null,"TypeScript",237,25,1,0,2,11,3,4.24,"MIT License",false,"main",true,[],"2026-06-12 02:00:27","# WikiOS\n\nWikiOS turns an Obsidian vault into a local web app. It lets you browse notes through a homepage, search, article pages, a graph view, and stats.\n\nBuilt by [Ansub](http:\u002F\u002Ftwitter.com\u002Fansubkhan), co-founder of [Supafast](https:\u002F\u002Fwithsupafast.com\u002F?utm_source=github&utm_medium=readme&utm_campaign=wikios) - we build websites for B2B SaaS & AI companies.\n\n\n\u003Cimg width=\"3024\" height=\"1324\" alt=\"CleanShot 2026-04-12 at 21 10 31@2x\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F86ca9f3e-db4b-4a21-96bc-fe18ba346ece\" \u002F>\n\n## What it does\n\n- Connects to an Obsidian-compatible markdown folder\n- Builds a local searchable index\n- Gives you a clean web interface for exploring your notes\n- Watches the vault for changes and updates the index automatically\n\n## How to get started\n\nClone and launch:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FAnsub\u002Fwiki-os.git wiki-os && cd wiki-os && npm run first-run\n```\n\nWikiOS will open in your browser and guide you through choosing a vault. You can also use the bundled demo vault on first run.\n\n## Features\n\n- Homepage with featured notes, recent notes, and people highlights\n- Fast local search\n- Clean article pages\n- Graph view\n- Stats view\n- Manual reindex support\n- Automatic file watching\n- Local-first setup with no cloud requirement\n\n### Docker\n\nYou can run WikiOS with Docker if you want a simple container setup.\n\nThis starts WikiOS with the bundled demo vault:\n\n```bash\ndocker compose up --build\n```\n\nThe `docker-compose.yml` file is in the main project folder.\n\nBy default, Docker uses the demo notes in `sample-vault\u002F`.\n\nIf you want to use your own Obsidian vault instead:\n\n1. Open `docker-compose.yml`\n2. Find this line:\n\n```yml\n- .\u002Fsample-vault:\u002Fvault:ro\n```\n\n3. Replace `.\u002Fsample-vault` with the path to your own vault\n\nExample:\n\n```yml\n- \u002FUsers\u002Fyour-name\u002FDocuments\u002FMyVault:\u002Fvault:ro\n```\n\nLeave `WIKI_ROOT: \u002Fvault` as it is.\n\nFor a direct build and run:\n\n```bash\ndocker build -t wiki-os .\ndocker run --rm -p 5211:5211 -e WIKI_ROOT=\u002Fvault -v \u002Fpath\u002Fto\u002Fyour\u002Fvault:\u002Fvault:ro -v wiki-os-data:\u002Fdata wiki-os\n```\n\n## Contributor mode\n\nFor normal users, use:\n\n```bash\nnpm start\n```\n\nFor contributors working on WikiOS itself, use:\n\n```bash\nnpm run dev\n```\n\n`dev` runs a split frontend\u002Fbackend setup for faster iteration.\n\n## Folder structure\n\n- `src\u002Fclient\u002F` contains the React app, routes, and UI components\n- `src\u002Fserver\u002F` contains the Fastify server, setup flow, runtime config, and platform helpers\n- `src\u002Flib\u002F` contains the wiki core\n- `sample-vault\u002F` contains the bundled demo content\n- `scripts\u002F` contains launch, deploy, and smoke-test helpers\n\n## Advanced\n\n### Useful commands\n\n- `npm run first-run` installs dependencies and starts the guided first-run flow\n- `npm start` starts the app in user mode\n- `npm run dev` starts the contributor split client\u002Fserver setup\n- `npm run build` builds the client and server\n- `npm run serve` runs the already-built server\n- `npm run deploy` runs the deployment helper\n- `npm run smoke-test` runs the smoke test helper\n- `docker compose up --build` runs the app in Docker with the bundled demo vault\n\n### Environment variables\n\n- `WIKI_ROOT` bootstraps the app with a vault path\n- `WIKIOS_FORCE_WIKI_ROOT` forces a temporary per-process vault override\n- `PORT` sets the server port\n- `WIKIOS_INDEX_DB` overrides the SQLite index path\n- `WIKIOS_ADMIN_TOKEN` protects the manual reindex endpoint\n- `WIKIOS_DISABLE_WATCH=1` disables filesystem watching\n\nBy default, WikiOS saves the selected vault in `~\u002F.wiki-os\u002Fconfig.json` and stores hashed SQLite indexes under `~\u002F.wiki-os\u002Findexes\u002F`.\n\n### People model\n\nWikiOS treats `People` as an explicit, user-controlled concept first. By default it recognizes people from:\n\n- frontmatter keys like `person`, `people`, `type`, `kind`, and `entity`\n- tags like `person`, `people`, `biography`, and `biographies`\n- folders like `people\u002F`, `person\u002F`, `biographies\u002F`, and `biography\u002F`\n\nYou can customize this in `wiki-os.config.ts` with `people.mode`:\n\n- `explicit` is the safest default\n- `hybrid` allows broader inference after explicit metadata\n- `off` hides People entirely\n\nLocal person overrides are saved in `~\u002F.wiki-os\u002Fconfig.json` and do not rewrite your notes.\n\n## License\n\nMIT\n","WikiOS 是一个将 Obsidian 笔记库转换为本地网页应用的工具。它通过主页、搜索功能、文章页面、图谱视图以及统计视图，让用户能够以更直观的方式浏览和探索笔记内容。该项目采用 TypeScript 编写，具备快速本地索引构建与自动更新功能，并提供了一个简洁美观的用户界面。WikiOS 适合需要在本地环境中高效管理和访问大量笔记资料的个人或团队使用，无需依赖云端服务即可实现数据的安全存储与便捷访问。","2026-06-11 02:43:37","CREATED_QUERY"]