Skip to content
Back to search

sonjari

SkillWorks with CodexGitHub

Your PC does the work. You get the proof. Sonjari is a free local AI agent for Windows: web research, Excel and Word documents, and code. Works on its own, or takes on tasks from Claude and Codex. No meter.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sonjari--sonjari/badge.svg)](/listings/sonjari--sonjari)

HTML

<a href="/listings/sonjari--sonjari"><img src="/api/listings/sonjari--sonjari/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 184 lines
  1. <h1 align="center">Sonjari (손자리)</h1>
  2. <p align="center">
  3. <b>An AI coworker that works in your own browser.</b><br>
  4. Runs on your GPU. No usage limits, no meter.
  5. </p>
  6. <p align="center">
  7. <b>The seat next to Claude Code.</b><br>
  8. When it runs out of usage or forgets after compaction, Sonjari picks it up.
  9. </p>
  10. <p align="center">
  11. <a href="LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue"></a>
  12. <img alt="Windows 10/11 x64" src="https://img.shields.io/badge/Windows-10%20%7C%2011%20x64-0078D4">
  13. <a href="https://apps.microsoft.com/detail/9N458V8HPTR2"><img alt="Microsoft Store" src="https://img.shields.io/badge/Microsoft%20Store-free-107C10"></a>
  14. <img alt="Runs on your GPU" src="https://img.shields.io/badge/runs%20on-your%20GPU-76B900">
  15. <a href="https://glama.ai/mcp/servers/sonjari/sonjari"><img alt="sonjari MCP server on Glama" src="https://glama.ai/mcp/servers/sonjari/sonjari/badges/score.svg" height="20"></a>
  16. </p>
  17. <p align="center">
  18. <a href="README.ko.md">한국어</a> ·
  19. <a href="https://sonjari.com">sonjari.com</a> ·
  20. <a href="CONTRIBUTING.md">Contributing</a> ·
  21. <a href="https://github.com/sonjari/sonjari/discussions">Discussions</a> ·
  22. <a href="SECURITY.md">Security</a>
  23. </p>
  24. ---
  25. ## An AI coworker in your own browser
  26. ```mermaid
  27. flowchart LR
  28. Y["You<br/>(app or phone)"] --> S["Sonjari<br/>on your GPU"]
  29. S -->|"opens · clicks · reads"| C["Your Chrome<br/>and files"]
  30. S --> R["Answer + file<br/>with the pages it read"]
  31. ```
  32. One sentence in, an Excel file out. Sonjari opens GitHub Trending, reads the top three Python repositories and saves name,
  33. stars and description as a table. Shown at about 9x; the real run took 2 min 46 s on an RTX 3090 with Qwen3.8 27B.
  34. https://github.com/user-attachments/assets/91763b31-fe72-4614-b574-b3457ef0518c
  35. | It does this | How | More |
  36. |---|---|---|
  37. | **Works in your logged-in Chrome — and you can watch** | Opens, clicks and reads pages in a Chrome profile on your PC. "Sonjari's computer" shows the page and the progress; add a note mid-task to change direction. Stops at login, CAPTCHA and payment and hands the screen to you. | [Browser](docs/guide/browser.md) |
  38. | **A job it did well once, it follows next time** | After a clean run it offers to keep the steps as a recipe, each step with the result it should see. Next time it opens the right screen directly and checks every step. | [Recipes](docs/guide/recipes.md) |
  39. | **Give it work from your phone** | Message your own Discord bot; the PC at home does the job and answers in the same chat. Approvals stay on the PC. | [Discord](docs/guide/remote.md) |
  40. ## The seat next to Claude Code
  41. ```mermaid
  42. flowchart LR
  43. CC["Claude Code · Codex · Cursor"] -->|"sonjari_task (MCP)"| S["Sonjari reads<br/>on this PC"]
  44. S -->|"only the result + a receipt"| CC
  45. L["Conversation logs"] -->|"scribe, while idle"| K["Cards: decided ·<br/>dropped · left to do"]
  46. K -->|"after compaction"| CC
  47. ```
  48. Claude Code hands the research to Sonjari over MCP. Sonjari reads the release page on this PC and only the answer, its
  49. source and a short receipt go back to Claude. Claude then checks it. Shown at 4x.
  50. https://github.com/user-attachments/assets/415a77b1-6126-45cb-afd3-88bf71ddbea9
  51. | It does this | How | More |
  52. |---|---|---|
  53. | **Your Claude, Codex or Cursor hands it the heavy reading** | `sonjari_task` over MCP. Pages are read on this PC; only the result comes back, so the host's context and usage are spared. In one price task, Claude's cost per complete row was $0.074–0.100 with Sonjari against $0.246 alone. | [MCP guide](docs/guide/mcp.md) |
  54. | **Picks up where Claude Code stopped at a usage limit** | Finds, from the records on this PC, which conversation stopped and how far it got, and asks how to continue. Code changes go to a separate branch. | [How we use it](docs/guide/workflows.md) |
  55. | **Keeps what you decided, even after compaction** | The scribe reads your Claude Code logs while Sonjari is idle and writes cards — decided, dropped, left to do — each with a line number and a quote. They go back to Claude right after a compaction. Off by default. | [Scribe](docs/guide/scribe.md) |
  56. ## What do you use your subagents for?
  57. A subagent, done properly: it takes the tedious part, does it on its own, and brings back only what you need.
  58. Your main agent should do the thinking. A subagent should take the part that is tedious and expensive: clicking through a
  59. booking site, reading twenty pages, filling in a form. In most setups that part still runs on the same paid model and the
  60. same usage limit.
  61. **Why an agent, not a set of tools.** We could have shipped Sonjari as browser tools for your AI. But then your AI still
  62. pays to read every page through its own context — the meter just moves from the agent to the hands. Sonjari is built on
  63. one premise: cut what you spend on the AI platform you already use. So it does the whole job on your GPU and sends back
  64. only the result.
  65. **Why we rebuilt the tools.** For the same reason, we took the browser tools apart and wrote our own, so a page comes back
  66. as the part that matters, not the whole page. We did not wrap an existing agent framework. The browser tools are where most
  67. of the work went.
  68. Same price task, Claude Code (`claude-sonnet-5`) in charge, 27 rows per way:
  69. | How Claude got the pages | Claude cost per complete row |
  70. |---|---|
  71. | A general browser tool (Playwright MCP) | $0.635 |
  72. | Claude alone (web fetch and search) | $0.246 |
  73. | Sonjari's browser tools, driven by Claude | $0.074–0.100 |
  74. | The whole task handed to Sonjari | $0.075–0.090 |
  75. Small numbers, some rows graded by hand, and slower: 6–7 minutes a task against about 1.5 for Claude alone.
  76. Every caveat: [What we measured](docs/guide/measurements.md#with-claude-code--same-task-clean-setup).
  77. It is not as smart as your main agent, and it is built not to pretend otherwise — every result says where it looked, so
  78. you or your main agent can check it.
  79. ## Will it run on my PC?
  80. | You need | |
  81. |---|---|
  82. | Windows | 10 (19041) or later, x64 |
  83. | GPU | NVIDIA (see the table below) |
  84. | [Ollama](https://ollama.com) | the first-run wizard offers to install it |
  85. | Chrome | for browser tasks (Edge works if Chrome is not installed) |
  86. | Your graphics card | What Sonjari recommends |
  87. |---|---|
  88. | RTX 3090 · 4090 · 5090 (24 GB or more) | the largest model (27B) |
  89. | RTX 4060 Ti 16GB · 4070 Ti Super · 4080 · 5070 Ti · 5080 (16 GB) | a compressed build of the same model |
  90. | RTX 3060 12GB · 4070 · 5070 (12 GB) | the mid-size model (9B) |
  91. | RTX 3060 Ti · 3070 · 4060 · laptop 4060 · 5050 (8 GB) | the mid-size model (9B), compressed, text only (no picture reading) |
  92. | laptop 3050 · 4050 (6 GB) | the small model (4B), compressed, text only — weak; best shared with the AI you already use |
  93. ## Install
  94. 1. Get it from the [Microsoft Store](https://apps.microsoft.com/detail/9N458V8HPTR2) — free, updates itself.
  95. 2. On first launch the wizard measures this PC, picks a model that fits, downloads it (several GB) and runs it once to
  96. check. ([Watch the first run](https://github.com/user-attachments/assets/c6dd2281-8981-404d-9222-d9f1534f79bc))
  97. 3. Press **Connect** in the app to add Sonjari to Claude Code, Claude Desktop, Codex or Cursor. The original config is
  98. backed up first. By hand: [MCP guide](docs/guide/mcp.md).
  99. Build from source: [Developing](#developing).
  100. ## Why you can check it
  101. - **It shows where it looked.** Every run leaves its steps, the pages it read and where each value came from.
  102. - **It flags what it cannot back up.** A number no tool returned is marked, and a job that did not finish says where it stopped.
  103. - **You press the irreversible buttons.** Sending, publishing, paying and deleting wait for an approval card in the app.
  104. Every number we have, including the runs that went badly: [What we measured](docs/guide/measurements.md).
  105. **Where it falls short:** Windows and NVIDIA only · slower than cloud AI · on small cards, long research gets about halfway ·
  106. fiddly page controls (autocomplete, date pickers, cookie overlays) fail often.
  107. ## Documentation
  108. | I want to … | Read |
  109. |---|---|
  110. | see how the maintainers use it day to day, with real numbers | [How we use it](docs/guide/workflows.md) |
  111. | use Sonjari from Claude Code, Codex or Cursor | [MCP guide](docs/guide/mcp.md) |
  112. | know exactly what leaves my PC when another AI uses Sonjari | [What leaves your PC](docs/guide/privacy.md) |
  113. | understand which model I got and what to do if it does not fit | [How Sonjari picks a model](docs/guide/models.md) |
  114. | add know-how or a whole field — skills, skill packs, domain packs (games, video) | [Skills and packs](docs/guide/packs.md) |
  115. | see every measurement and its limits | [What we measured](docs/guide/measurements.md) |
  116. | read the rules it keeps — local first, no meter, honest results, you press the irreversible buttons | [Principles](docs/why.md) |
  117. ## Contributing
  118. > **Whatever your work is, your field experience is Sonjari's teacher.**
  119. > Every failure you report becomes a test Sonjari must pass, forever.
  120. Measure it on your card, fix one site with a two-line JSON file, report a run that went wrong, write a text-only skill
  121. pack, or send code with one test. Details: [CONTRIBUTING.md](CONTRIBUTING.md).
  122. ## Developing
  123. ```powershell
  124. powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install.ps1
  125. .venv\Scripts\python.exe -m alture_jarvis
  126. .venv\Scripts\python.exe -m pytest tests -q -p no:cacheprovider
  127. cd ui; npm ci; npm run build
  128. ```
  129. Copy `.env.example` to `.env` only if you need to change a default. Never commit `.env`, `data/`, OAuth tokens or browser
  130. profiles. Internal names (`alture_jarvis` package, `JARVIS_*` variables, `X-JARVIS-TOKEN` header) come from the project's
  131. earlier name and are kept so existing installs keep working.
  132. Sonjari is maintained by two people, so replies can be slow. Much of the code is written with Claude (Anthropic) as a coding
  133. collaborator — commits carry a `Co-Authored-By` line — and every change is run, checked and released by the maintainers.
  134. ## License
  135. Apache License 2.0 — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
  136. Third-party components keep their own licenses; see `packaging/THIRD_PARTY_NOTICES.md`.
  137. The optional camera module uses Ultralytics YOLO (AGPL-3.0); it is **not** installed by default.
  138. "Sonjari", "손자리" and the Sonjari logo are trademarks. The license covers the code, not the name or logo
  139. (Apache-2.0, section 6). Forks are welcome under a different name.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.