Tiphys
The autonomous research agent that learns.
Drop Tiphys into any system. It explores, hypothesizes, experiments, and builds knowledge over time. The longer it runs, the deeper it understands.
Powered by the Castor security kernel for checkpoint/replay, budget control, and human-in-the-loop approval.
Early alpha. APIs will change. Feedback welcome.
Install
pip install tiphys-ai
Quick Start
# Interactive setup (configure LLM provider + API key)
tiphys onboard
# Run autonomous research on a system
tiphys research "Find performance bottlenecks in this API"
# View what the agent has learned
tiphys genome
# Start the web gateway
tiphys gateway
What It Does
Research — Give it a goal. It decomposes the goal into questions, investigates each one (hypothesis → experiment → conclusion), and writes findings as human-readable markdown documents.
Learn — It learns from failures. The evolution subsystem analyzes past mistakes, distills them into skills and knowledge, and injects them into the agent's prompt. It gets better over time.
Safe — Budget caps prevent runaway costs. Human-in-the-loop gates block risky actions. Checkpoint/replay enables rollback and time-travel debugging.
Key Capabilities
- Autonomous Research — Planner decomposes goals, Researcher runs hypothesis-experiment-conclusion loops, findings accumulate as documents
- Self-Evolution — Consolidator learns from failures, Tool Forge builds new tools, Arena validates via counterfactual replay
- 22 Built-in Tools — File I/O, code search (grep/glob), structured editing, shell execution, memory, scheduling
- Document-Based Knowledge — Findings stored as markdown with frontmatter (confidence, evidence, tags) — readable by humans and LLMs
- Checkpoint/Replay — Crash recovery, time-travel rollback, fork for counterfactual evaluation
- Multi-Agent — Spawn sub-agents with isolated sessions and delegated budgets
- Proactive — Background observer suggests actions (uncommitted changes, untested code, new learnings)
License
Apache 2.0
Metadata
Release files for tiphys-ai 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tiphys_ai-0.4.1.tar.gz | 7.3 MB | Without provenance | Details for tiphys_ai-0.4.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tiphys_ai-0.4.1-py3-none-any.whl | Python 3 | none | any | Details for tiphys_ai-0.4.1-py3-none-any.whl |
Total release size: 7.5 MB
Release files / tiphys_ai-0.4.1.tar.gz
| Download URL | tiphys_ai-0.4.1.tar.gz |
|---|---|
| Size | 7.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dac8a0c687059cd1a75752f8a3320a0174ddd8b4822c6f2035848c1d7dc65675
|
|
BLAKE2b-256 checksum How to use checksums |
7ddc8b4f66a942b9ead323d563a67ce1871b8a96099a54d9c5599cd75f81ed3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / tiphys_ai-0.4.1-py3-none-any.whl
| Download URL | tiphys_ai-0.4.1-py3-none-any.whl |
|---|---|
| Size | 266.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c7d9fba262d3244e2817e10ac6badfd26baa510481e3273c92af894d3bc9a235
|
|
BLAKE2b-256 checksum How to use checksums |
4ec6f2b20bb9781526693e9f7502d436e3e168c642718935ca84f48895ef25d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for tiphys-ai 0.4.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.