[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-93256":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":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":23,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},93256,"personal-model","Intuition-Lab\u002Fpersonal-model","Intuition-Lab","Build your HUMAN.md.","https:\u002F\u002Fintuition-lab.github.io\u002Fpersonal-model\u002F",null,"Python",399,30,8,6,0,169,232,74.47,"Apache License 2.0",false,"main",true,[25,26,27,28,29,5,30,31],"agent-memory","local-first","macos","mcp","personal-ai","privacy","python","2026-07-22 04:02:08","# Persome: Build your Personal Model\n\n\u003C!-- mcp-name: io.github.Intuition-Lab\u002Fpersonal-model -->\n\n**The open-source Personal Model that makes every AI yours.**\n\nPersome learns how you actually think and work from focused activity captured on your Mac after you grant macOS permission—then gives Codex, Claude Code, and other trusted MCP-compatible clients evidence-linked context to continue your work and make grounded decisions.\n\n**Runs locally on your Mac. Private by default. Yours to inspect, correct, export, and delete.**\n\n[![CI](https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model\u002Factions\u002Fworkflows\u002Fci.yml) [![Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002FIntuition-Lab\u002Fpersonal-model)](https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model\u002Freleases) [![License: Apache-2.0](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode-Apache--2.0-blue)](LICENSE) [![macOS 13+](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FmacOS-13%2B-black)](#2-install-with-your-data) [![MCP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Finterface-MCP-0b7285)](MCP.md) [![Official MCP Registry](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOfficial_MCP_Registry-Persome-6f42c1)](https:\u002F\u002Fregistry.modelcontextprotocol.io\u002F?q=Persome)\n\n[Try the synthetic demo](#1-five-minute-synthetic-demo) · [Install with your data](#2-install-with-your-data) · [Connect an MCP client](#3-connect-a-trusted-mcp-client) · [Star Persome on GitHub](https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model)\n\n![Illustration of a mature Persome Personal Model with evidence-linked Points, Lines, Faces, Volumes, and a Root](docs\u002Fassets\u002Freadme\u002Fpersonal-model.png)\n\n_Concept illustration of a mature Personal Model. The deterministic Runtime proof is shown in the demo below._\n\n---\n\n## What is it?\n\nYour `HUMAN.md`\n\nPersome connects activity into progressively deeper context:\n\n| Layer | Meaning |\n| --- | --- |\n| **Point** | A sourced observation or event |\n| **Line** | A relationship or change over time |\n| **Face** | A pattern supported by related evidence |\n| **Volume** | A higher-order structure across projects or areas of life |\n| **Root** | The current integrated model of you |\n\nNew evidence can strengthen, revise, or overturn an earlier inference. Every important claim keeps receipts.\n\n---\n\n## Use cases\n\n### 1. One Root — A Model of You\n\n**Thousands of moments. One evolving model of you.**\n\nPersome turns sourced observations into relationships, patterns, higher-order structure, and one current Root: what matters now, how you tend to decide, and where your attention is moving.\n\n\u003Cp align=\"center\">\u003Cimg src=\"docs\u002Fassets\u002Freadme\u002Fone-root.png\" alt=\"One Root — A Model of You. An activity stream becomes 1,000+ Points, 300+ Lines, 80+ Faces, 20+ Volumes, and one evolving model. A Personal Model example on the right shows current goals and quality standards.\" width=\"100%\">\u003C\u002Fp>\n\nFrom Points to Lines, Faces, Volumes, and one Root—a living model of who you are and what matters now.\n\n### 2. Same AI. Different You.\n\n\u003Cp align=\"center\">\u003Cimg src=\"docs\u002Fassets\u002Freadme\u002Fsame-ai-different-you.png\" alt=\"\" width=\"100%\">\u003C\u002Fp>\n\n**The model is the same. The person it understands is different.**\n\nTwo people can give the same AI the same prompt and deserve different answers. Your Personal Model changes how an agent prioritizes, decides, writes, and acts—because it understands who it is working for.\n\nThe same prompt should not produce the same answer for everyone. Give AI a model of you.\n\n### 3. One MCP — Turn coding agents into proactive agents\n\n\u003Cp align=\"center\">\u003Cimg src=\"docs\u002Fassets\u002Freadme\u002Fone-mcp.png\" alt=\"\" width=\"100%\">\u003C\u002Fp>\n\n**Your coding agent finds its own work**\n\nConnect Persome once through MCP. Codex, Claude Code, and other trusted agents can use the same model of your goals, priorities, working patterns, and boundaries.\n\nPersome identifies unfinished work, ranks it against your priorities, and separates safe local tasks from decisions that need you. The connected agent executes; you keep authority over external actions.\n\n#### Continue where you left off\n\n\u003Cp align=\"center\">\u003Cimg src=\"docs\u002Fassets\u002Freadme\u002Fcontinue-where-you-left-off.png\" alt=\"Persome helps a coding agent continue unfinished work. The left panel lists README, onboarding, and MCP tasks; the Codex panel restores the previous work state, current goal, next step, project directory, Git status, and unstaged changes.\" width=\"100%\">\u003C\u002Fp>\n\n#### Work while you sleep\n\n\u003Cp align=\"center\">\u003Cimg src=\"docs\u002Fassets\u002Freadme\u002Fwork-while-you-sleep.png\" alt=\"Persome Work While You Sleep interface. It organizes 30 open loops, filters five tasks that are safe to complete by permission scope and action type, and presents a morning report of completed local work, pending decisions, external actions, and permission boundaries.\" width=\"100%\">\u003C\u002Fp>\n\n---\n\n## Install, connect, and verify\n\n**Choose the path that matches what you want to prove.** The synthetic demo and the real-data install are intentionally separate.\n\n### 1. Five-minute synthetic demo\n\nTry the complete Persome model without touching your personal data. This path requires Git and [uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F), but no API key, macOS Accessibility permission, or access to your existing `~\u002F.persome` data.\n\n```text\ngit clone https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model.git\ncd personal-model\nuv run python scripts\u002Fsample_demo.py\n```\n\nThe script opens the local viewer at `http:\u002F\u002F127.0.0.1:8743\u002Fmodel` and deletes its temporary synthetic data when you press `Ctrl-C`. Add `--showcase` for the denser, still fully synthetic graph shown below.\n\n![Persome local personal-model viewer rendering a dense synthetic Point, Line, Face, Volume, and Root graph](docs\u002Fassets\u002Fpersome-model-hero.png)\n\n_Actual `\u002Fmodel` screenshot produced by `scripts\u002Fsample_demo.py --showcase`: 424 synthetic Points, 146 Lines, 12 Faces, 4 Volumes, and 1 Root. It contains no personal data._\n\n### 2. Install with your data\n\nRequirements: macOS 13 or newer and Xcode Command Line Tools. For the shortest package-managed installation:\n\n```text\nuv tool install personal-model\npersome onboard\npersome model open --after 30\n```\n\nThe distribution is named `personal-model`; the installed CLI is `persome`.\n\nFor the most explicit source-based first run:\n\n```text\ngit clone https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model.git\ncd personal-model\nbash install.sh\n```\n\nAfter successful interactive onboarding, the source installer schedules the one-shot 30-minute viewer reminder automatically.\n\n**What onboarding proves**\n\n- `persome onboard` explains each macOS request before it appears.\n- Accessibility is granted to the versioned `mac-ax-helper` and, only when event-driven capture is enabled, `mac-ax-watcher`.\n- Screen Recording is requested only when the effective screenshot or local-OCR policy requires pixels. Persome never requires Full Disk Access.\n- On Apple Silicon, onboarding verifies the isolated local OCR worker when OCR is enabled.\n- It proves the final lifecycle owner and Runtime generation, then reports a fresh-capture receipt in standard daemon mode or an explicit readiness\u002Fprivacy receipt for supported alternate modes such as trusted ingest.\n\nAn LLM is optional for collection and BM25 recall, but required for semantic modeling. If provider setup was skipped, run:\n\n```text\npersome llm setup\npersome llm status --check\n```\n\n### 3. Connect a trusted MCP client\n\nRegister whichever owner-local clients you use:\n\n```text\npersome install claude-code\npersome install codex\npersome install claude-desktop\npersome install opencode\n```\n\nThese stdio registrations launch the MCP process on demand, so the daemon does\nnot need to be running after onboarding has initialized the local database, and\nno HTTP bearer is copied into client configuration. Schema creation and\nmigration remain daemon-owned; a brand-new or externally upgraded data root\nmust run `persome start` once before stdio clients use it. Stdio writes remain\navailable while the daemon is stopped, but WAL maintenance waits for the daemon;\nstart it periodically if you use write tools in that mode so the WAL stays bounded.\n\nFor Cursor, generate a stdio configuration and merge its `mcpServers.persome` object into `.cursor\u002Fmcp.json` or `~\u002F.cursor\u002Fmcp.json`:\n\n```text\npersome install mcp-json --filename persome-mcp.json\n```\n\n> MCP access is a personal-data capability; register only clients you trust.\n\n### 4. Verify and ask grounded questions\n\n```text\npersome status\npersome model status\npersome model open\n\n# Only if you configured a semantic provider:\npersome llm status --check\n```\n\nA sparse or degraded model can be valid early; Persome reports missing geometry instead of fabricating Faces, Volumes, or a Root.\n\nAfter connecting an MCP client, try:\n\n> Search my Persome memory for **[topic]**. Use `search`, open the strongest result with `read_receipt`, and cite the source path, timestamp, and receipt ID. If the evidence is missing or conflicting, say so instead of guessing.\n\nActive work is reduced every five minutes by default. With valid capture and a working semantic provider, a first useful recall is operationally expected within about ten minutes—not guaranteed as a benchmark result.\n\n### 5. Update Persome\n\nFor a `uv tool` installation, upgrade with the package manager and re-run Runtime proof:\n\n```text\nuv tool upgrade --python 3.12 personal-model\npersome onboard\npersome model open --after 30\n```\n\nAfter any upgrade, restart editors that host a Persome stdio MCP process before\nresuming Runtime writes. A process loaded from the previous release cannot join\nthe new cross-process SQLite maintenance gate until the editor reconnects it.\n\nFor an installation created by `install.sh`, run the transactional updater from any directory:\n\n```text\npersome update\n```\n\n`persome update` preserves configuration, credentials, personal data, capture policy, and lifecycle intent, and performs its own mode-aware onboarding before committing the update. Do not use it to update a package-manager-managed installation.\n\n---\n\n\u003Cp align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model\">\u003Cb>Star Persome on GitHub\u003C\u002Fb>\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fregistry.modelcontextprotocol.io\u002F?q=Persome\">Official MCP Registry\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model\u002Fblob\u002Fmain\u002Fdocs\u002Fmcp-clients.md\">MCP client setup\u003C\u002Fa> · \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FIntuition-Lab\u002Fpersonal-model\u002Fblob\u002Fmain\u002FSECURITY_PRIVACY.md\">Security & privacy\u003C\u002Fa>\u003C\u002Fp>\n\n\u003Cdetails>\n\u003Csummary>Contributors\u003C\u002Fsummary>\n\n\u003C!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n\u003Ctable>\n  \u003Ctbody>\n    \u003Ctr>\n      \u003Ctd valign=\"middle\">\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSingularity-tian\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F113085728?v=4&size=112\" width=\"56\" align=\"left\" alt=\"Singularity\" \u002F>\u003C\u002Fa>\n          \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSingularity-tian\">Singularity\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr \u002F>\n          \u003Csub>💻 Code\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd valign=\"middle\">\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FGouBuliya\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F163627234?v=4&size=112\" width=\"56\" align=\"left\" alt=\"Li_Xufeng\" \u002F>\u003C\u002Fa>\n          \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FGouBuliya\">Li_Xufeng\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr \u002F>\n          \u003Csub>💻 Code\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd valign=\"middle\">\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSiyiZhu1\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F132850441?v=4&size=112\" width=\"56\" align=\"left\" alt=\"Siyi\" \u002F>\u003C\u002Fa>\n          \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSiyiZhu1\">Siyi\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr \u002F>\n          \u003Csub>🎨 Design\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd valign=\"middle\">\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fkevinaimonster\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F172621334?v=4&size=112\" width=\"56\" align=\"left\" alt=\"Kevin\" \u002F>\u003C\u002Fa>\n          \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fkevinaimonster\">Kevin\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr \u002F>\n          \u003Csub>💻 Code\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd valign=\"middle\">\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhuachenjie238-oss\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F261379605?v=4&size=112\" width=\"56\" align=\"left\" alt=\"huachenjie238-oss\" \u002F>\u003C\u002Fa>\n          \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhuachenjie238-oss\">huachenjie238-oss\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr \u002F>\n          \u003Csub>📈 Growth\u003C\u002Fsub>\n      \u003C\u002Ftd>\n      \u003Ctd valign=\"middle\">\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FJingYangGit\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F169429757?v=4&size=112\" width=\"56\" align=\"left\" alt=\"Jing@Meowy\" \u002F>\u003C\u002Fa>\n          \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FJingYangGit\">Jing@Meowy\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr \u002F>\n          \u003Csub>📈 Growth\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n    \u003Ctr>\n      \u003Ctd valign=\"middle\">\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FAMTso7aw\">\u003Cimg src=\"https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F113247039?v=4&size=112\" width=\"56\" align=\"left\" alt=\"Zhiheng Chen\" \u002F>\u003C\u002Fa>\n          \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FAMTso7aw\">Zhiheng Chen\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr \u002F>\n          \u003Csub>💻 Code\u003C\u002Fsub>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C!-- ALL-CONTRIBUTORS-LIST:END -->\n\n\u003C\u002Fdetails>\n","Persome 是一个运行在 macOS 上的本地化个人模型构建工具，通过捕获用户日常活动（如文档编辑、代码编写、网页浏览等）生成可验证、可追溯的‘人类模型’（HUMAN.md）。它基于 MCP（Model Context Protocol）协议，采用分层知识结构（Point\u002FLine\u002FFace\u002FVolume\u002FRoot）组织证据链，支持模型自解释与持续演进，全程离线运行，保障隐私与数据主权。适用于希望构建个性化 AI 助手、增强认知连续性、或实现工作流上下文自动沉淀的知识工作者与开发者。",2,"2026-07-14 02:30:07","CREATED_QUERY"]