An AI-powered coding assistant
Project description
Hypergolic
An agentic collaboration tool
Key Features
- Tool loop — Files, shell, git, browser automation, and more, exposed through configurable human-approval rules.
- Persistent knowledge graph — Accumulates corrections, preferences, and project context in a local SQLite database.
- Layered system prompt — Compose behavior from a base prompt, user prompt, and per-project prompt.
- Session continuity — Conversations persist and are resumable.
- Skills and roles — Activate specialized expertise (debugging, frontend, product thinking, etc.) on demand.
- MCP integration — Connect external tool servers via Model Context Protocol.
- Custom tools — Wrap any shell command as a tool the assistant can invoke.
Quick Start
# Install dependencies
curl -LsSf https://astral.sh/uv/install.sh | sh
brew install ripgrep # optional, for faster search
# Install Hypergolic
uv tool install hypergolic
# Set API credentials
export HYPERGOLIC_API_KEY="your-api-key"
export HYPERGOLIC_BASE_URL="https://api.anthropic.com"
# Launch (from any git repo)
h
See the Installation Guide for full details.
Documentation
- Installation — Requirements, install, environment setup
- Getting Started — First launch, interface overview, keyboard shortcuts
- Configuration — Config files, system prompt assembly, user and project prompts
- Tools — Built-in tools, approval system, custom tools
- Advanced Usage — Custom tools, MCP servers, skills, roles, knowledge graph, browser automation
Why "Hypergolic"?
In chemistry, hypergolic propellants are two distinct compounds that ignite on impact. Their most common application is as rocket fuel, where hydrazine and dinitrogen tetroxide ignite upon touching. Used carelessly, they're hazardously toxic and explosive. Used right, they help us reach the stars. Those same opportunities and risks exist within modern agentic tools.
In several domains, human <> ML collaboration is more effective than either acting alone. One famous example is "Centaur Chess" where a human using an moderately-powerful AI can outperform advanced AI models. Whether or not this remains true in the future, I think the metaphor holds for agentic coding. Humans benefit from the velocity, depth, and breadth LLMs bring to the table. At the same time, human review and ideation can bring judgment and rigor to technical outcomes beyond purely vibe-coded approaches. In a way, humans and AI agents are hypergolic.
Hypergolic strives to help humans and agents get the most out of their work. The two-sided UX encourages seamless agent<>human interaction. The project's approach towards transparent configuration and sensible defaults lets both entities refine their tooling. And an extensible, shared framework means that that both the agent and the human become more knowledgeable and productive over time.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hypergolic-0.11.0.tar.gz.
File metadata
- Download URL: hypergolic-0.11.0.tar.gz
- Upload date:
- Size: 926.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dfd469239b23e81d39e8760d25af4729895fa3ebbac246c6c0e9a90cc02e380c
|
|
| MD5 |
82e3e2735f29773d0327dd939bf9138b
|
|
| BLAKE2b-256 |
41b178af5499ba98fc970449071490f82cb6dd2271a09b3ec38b855da381a8aa
|
Provenance
The following attestation bundles were made for hypergolic-0.11.0.tar.gz:
Publisher:
publish.yml on RobertTownley/hypergolic
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hypergolic-0.11.0.tar.gz -
Subject digest:
dfd469239b23e81d39e8760d25af4729895fa3ebbac246c6c0e9a90cc02e380c - Sigstore transparency entry: 1256867199
- Sigstore integration time:
-
Permalink:
RobertTownley/hypergolic@690ff85057e0ec778bec8ed4a7be5d4606be4c12 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/RobertTownley
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@690ff85057e0ec778bec8ed4a7be5d4606be4c12 -
Trigger Event:
push
-
Statement type:
File details
Details for the file hypergolic-0.11.0-py3-none-any.whl.
File metadata
- Download URL: hypergolic-0.11.0-py3-none-any.whl
- Upload date:
- Size: 922.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bdc76c082814793c9eb339399d874bc0ede6a873a0d90a617dde82dae6a04a03
|
|
| MD5 |
4bc9e7ad88c4024b031d19ce131997ec
|
|
| BLAKE2b-256 |
b142ca58c397332b95d581fecf806c93babcebcca333bfe8fb878c8c706c2519
|
Provenance
The following attestation bundles were made for hypergolic-0.11.0-py3-none-any.whl:
Publisher:
publish.yml on RobertTownley/hypergolic
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hypergolic-0.11.0-py3-none-any.whl -
Subject digest:
bdc76c082814793c9eb339399d874bc0ede6a873a0d90a617dde82dae6a04a03 - Sigstore transparency entry: 1256867274
- Sigstore integration time:
-
Permalink:
RobertTownley/hypergolic@690ff85057e0ec778bec8ed4a7be5d4606be4c12 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/RobertTownley
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@690ff85057e0ec778bec8ed4a7be5d4606be4c12 -
Trigger Event:
push
-
Statement type: