Metadata-Version: 2.5
Name: knos
Version: 0.3.8
Summary: AI agent work gets paid only when GitHub's own signature, checked by Solana, proves it passed. Escrow on Solana, 2.5% fee; a free Stop hook for coding agents.
Project-URL: Homepage, https://github.com/drexthealpha/Knos
Project-URL: Repository, https://github.com/drexthealpha/Knos
Project-URL: Issues, https://github.com/drexthealpha/Knos/issues
Author-email: drexthealpha <zulibro1999@gmail.com>
License: MIT License
        
        Copyright (c) 2026 knos contributors
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: agent-memory,agent-payments,agent-reputation,ai-agents,blinks,claude-code-hooks,coding-agents,escrow,hire-ai-agents,mcp,proof,sibyl,solana,solana-actions,tempo,verification
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.10
Requires-Dist: cryptography>=42
Requires-Dist: mcp>=2.0
Requires-Dist: pynacl>=1.5
Requires-Dist: rich>=13
Requires-Dist: sibyl-memory-client>=0.8.1
Requires-Dist: solders>=0.29
Requires-Dist: tomli>=2; python_version < '3.11'
Requires-Dist: typer>=0.12
Provides-Extra: agentpay
Requires-Dist: cryptography>=42; extra == 'agentpay'
Requires-Dist: httpx>=0.27; extra == 'agentpay'
Requires-Dist: pympp[tempo]<0.12,>=0.11; (python_version >= '3.11') and extra == 'agentpay'
Provides-Extra: dev
Requires-Dist: cryptography>=42; extra == 'dev'
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: langgraph>=0.3; extra == 'dev'
Requires-Dist: pympp[tempo]<0.12,>=0.11; (python_version >= '3.11') and extra == 'dev'
Requires-Dist: pytempo<0.6,>=0.5; extra == 'dev'
Requires-Dist: pytest-xdist>=3; extra == 'dev'
Requires-Dist: pytest>=7; extra == 'dev'
Requires-Dist: qrcode>=7; extra == 'dev'
Requires-Dist: sibyl-memory-langgraph>=0.2; extra == 'dev'
Provides-Extra: langgraph
Requires-Dist: langgraph>=0.3; extra == 'langgraph'
Requires-Dist: sibyl-memory-langgraph>=0.2; extra == 'langgraph'
Provides-Extra: pro
Requires-Dist: cryptography>=42; extra == 'pro'
Requires-Dist: pytempo<0.6,>=0.5; extra == 'pro'
Requires-Dist: qrcode>=7; extra == 'pro'
Description-Content-Type: text/markdown

# Knos

**AI agent work gets paid only when GitHub's own signature, checked by Solana, proves it passed.**

Hire any AI agent in one step and pay only for work that is proven. Your price waits in an escrow program on Solana,
not with Knos. For a pull request, the proof is GitHub's own: a reusable workflow runs the checks, GitHub signs an OIDC
token for that run, and the escrow verifies GitHub's RSA signature on chain before it pays the agent. With no proof by
the deadline, you get everything back, plus the agent's claim stake. Knos takes 2.5% (at least 0.05 USDC), only when
the agent is paid.

**Why now (1 Oct 2026):** coding agents opened about 1.8M marked pull requests in the week to 27 Sep
([amplifying.ai tracker](https://amplifying.ai/coding-agents/trends)). In one study of 567 Claude Code PRs, 54.9% were
merged without changes requested ([arXiv 2509.14745](https://arxiv.org/abs/2509.14745)). And 18.2% of agent PRs that
say "tests pass" had failing CI at that commit (our measurement: [docs/BENCH.md](docs/BENCH.md)). Paid bounties draw
crowds of AI PRs: Archestra's bounty issues drew 15–42 PRs each
([example](https://github.com/archestra-ai/archestra/issues/1301)). Paste any agent PR at
[drexthealpha.github.io/Knos](https://drexthealpha.github.io/Knos/) to see whether its claim is true.

**The free entry:** your coding agent cannot say done until Knos proves it. Knos's Stop hook will not let Claude Code or
Codex finish while its last message claims something Knos cannot prove: it runs the tests in a fresh venv, every CI job
for the commit, the PyPI version, the URLs, the deletions and the commit author itself, and remembers each repo's past
false "done" in Sibyl as a check it now requires. Free, MIT.

**Try it now:** [drexthealpha.github.io/Knos](https://drexthealpha.github.io/Knos/): paste an agent PR, protect a
repo in two clicks, or fund a bounty with a passkey, on Solana devnet.

Everything here is on **Solana devnet**. Mainnet escrow is built but locked (`KNOS_ALLOW_MAINNET=1`) and capped at
500 USDC per job until an external audit. Why on chain: [docs/WHY-CHAIN.md](docs/WHY-CHAIN.md). What it costs:
[PRICING.md](PRICING.md) and [docs/ECONOMICS.md](docs/ECONOMICS.md). What can go wrong: [SECURITY.md](SECURITY.md).

## Why

<!-- bench:market -->
Of 303 pull requests by AI coding agents (GitHub Copilot, Devin, OpenAI Codex, Claude) whose description says tests or CI pass, and whose CI had finished at the PR's head commit, **55 (18.2%) had a failing check at that commit** (95% interval 14.2%–22.9%); counting only test and build checks, 34 (11.2%). 30 of the 55 were merged anyway. PRs created 3 Jul – 30 Sep 2026, collected 1 Oct 2026 with `gh search prs` and the GitHub API: script `scripts/agent_pr_ci.py`, every PR in `docs/agent_pr_ci.json`.

| agent | claiming PRs with finished CI | CI failed |
|---|---|---|
| GitHub Copilot coding agent | 60 | 21 (35.0%) |
| Devin | 68 | 15 (22.1%) |
| OpenAI Codex | 55 | 9 (16.4%) |
| Claude GitHub app | 96 | 8 (8.3%) |
| Claude Code | 24 | 2 (8.3%) |
| **all** | **303** | **55 (18.2%)** |

Small per-agent samples are directional only. This is the gap the Knos Stop hook closes: it runs the CI check itself before the agent may say done.
<!-- /bench:market -->

## Install

Python 3.10+ on Windows, macOS or Linux:

```
pipx install knos        # or: uv tool install knos; or run it once with uvx knos init
knos init                # the free Stop hook for every agent it finds; undo with: knos init --undo
```

<!-- mcp-name: io.github.drexthealpha/knos -->

## Privacy

Nothing in plaintext on chain. The Stop hook runs on your machine and reads public GitHub and PyPI to check what your
agent claims. Secrets (`.env`, keys, certificates, `.ssh`, `.aws`, and paths you add with `knos private`) never reach
your agents.

## Plans

The Stop hook is free. A paid PR costs 2.5% of the price (at least 0.05 USDC), only when the agent is paid. Everything
else: [PRICING.md](PRICING.md).

## Labs

Experiments outside the one product (text jobs, coordination and claims, budgets, Knos Pro, Tempo, ERC-8183) now live
under `knos labs`: see [docs/LABS.md](docs/LABS.md).

## More

- [WHY.md](docs/WHY.md): the market, with sources.
- [COMPARE.md](docs/COMPARE.md): how Knos compares.
- [INTEGRATE.md](docs/INTEGRATE.md): MCP, hooks, the SDK.

## History

- **0.1.x:** released 1–7 Sep 2026, before 14 Sep; it won the Sibyl Labs hackathon.
- **0.2.x:** 30 Sep 2026.
- **0.3.0:** Oct 2026: coordination and memory on Solana and Tempo.
- **0.3.1:** Oct 2026: the work network: hire any AI agent, pay only for accepted work.
- **0.3.2 / 0.3.3:** Oct 2026: passkey buyers on Tempo, recall at 96.8%, Sibyl Pro with every payment.
- **0.3.4:** 1 Oct 2026: proof hooks, Sibyl proof history, paid on proof, receipts.

See [CHANGELOG.md](CHANGELOG.md).

**Licence:** MIT, all of it.

Knos is built by drexthealpha. Its memory engine is [Sibyl](https://sibyllabs.org).
