Skip to content

docs: sync README with repo description + document discovery driver #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thebeastagi merged 1 commit into from
Jul 19, 2026
Merged

docs: sync README with repo description + document discovery driver #6

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 19 additions & 8 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,17 @@
[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)](pyproject.toml)

SAPIENS is an **experimental research platform** for traceable, cross-domain
scientific-discovery workflows. It provides the plumbing a discovery system
needs before it can be trusted: a domain-neutral adapter boundary, an
append-only hash-chained evidence ledger, kernel-owned promotion gates, an
epistemically conservative cross-domain bridge, and bounded background
autonomy.
SAPIENS is an **experimental platform for traceable cross-domain
scientific-discovery workflows** — a `DomainAdapter` boundary, a hash-chained
L0→L4 evidence ledger, and kernel-gated promotions. **Phase 0: synthetic
adapters only, no discoveries claimed.**

It provides the plumbing a discovery system needs before it can be trusted:
a domain-neutral adapter boundary, an append-only hash-chained evidence
ledger, kernel-owned promotion gates, an epistemically conservative
cross-domain bridge, bounded background autonomy, and an autonomous
discovery driver that climbs candidates through the gates under strict
budgets.

> **Read this first — despite the acronym:** SAPIENS is **not** AGI, ASI, or
> superintelligence, and does not claim to be. It is an experimental research
Expand Down Expand Up @@ -41,6 +46,9 @@ src/sapiens/
budget.py cooperative step/time budgets and preemption exceptions
queue.py bounded SQLite job queue with leases and idempotency
daemon.py preemptible background worker skeleton
discovery.py autonomous discovery driver — proposes candidates and
climbs them L0→L3 under budgets via the daemon; L4 stays
human-gated
cli.py synthetic-only demo entrypoint
adapters/ three deterministic synthetic adapters (linear, threshold,
periodic-signal photometry)
Expand Down Expand Up @@ -88,10 +96,13 @@ ruff check src tests
pytest

# synthetic end-to-end demo (the installed `sapiens` command is equivalent)
python -m sapiens.cli
python -m sapiens.cli # bare invocation = `demo` subcommand

# optionally keep the generated evidence ledger for inspection
python -m sapiens.cli --workdir .sapiens-demo
python -m sapiens.cli demo --workdir .sapiens-demo

# autonomous discovery driver over the synthetic adapters (bounded + budgeted)
python -m sapiens.cli discover --max-seconds 10
```

The CLI proposes deterministic synthetic candidates in the kinematics and
Expand Down
Loading