Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hypergolic-0.11.0.tar.gz (926.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hypergolic-0.11.0-py3-none-any.whl (922.1 kB view details)

Uploaded Python 3

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

Hashes for hypergolic-0.11.0.tar.gz
Algorithm Hash digest
SHA256 dfd469239b23e81d39e8760d25af4729895fa3ebbac246c6c0e9a90cc02e380c
MD5 82e3e2735f29773d0327dd939bf9138b
BLAKE2b-256 41b178af5499ba98fc970449071490f82cb6dd2271a09b3ec38b855da381a8aa

See more details on using hashes here.

Provenance

The following attestation bundles were made for hypergolic-0.11.0.tar.gz:

Publisher: publish.yml on RobertTownley/hypergolic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for hypergolic-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bdc76c082814793c9eb339399d874bc0ede6a873a0d90a617dde82dae6a04a03
MD5 4bc9e7ad88c4024b031d19ce131997ec
BLAKE2b-256 b142ca58c397332b95d581fecf806c93babcebcca333bfe8fb878c8c706c2519

See more details on using hashes here.

Provenance

The following attestation bundles were made for hypergolic-0.11.0-py3-none-any.whl:

Publisher: publish.yml on RobertTownley/hypergolic

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page