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.10.3.tar.gz (991.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.10.3-py3-none-any.whl (1.0 MB view details)

Uploaded Python 3

File details

Details for the file hypergolic-0.10.3.tar.gz.

File metadata

  • Download URL: hypergolic-0.10.3.tar.gz
  • Upload date:
  • Size: 991.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for hypergolic-0.10.3.tar.gz
Algorithm Hash digest
SHA256 a49bb3242f7cad18624affed951b122124aeb464a6d10f7d2815e862f5e604b1
MD5 ae03098efd4155346e0b478e82a1dd4f
BLAKE2b-256 e4ae551cf1f8a3fd74f9c0b0346d0c9d8f93426f8385229f5f88ebb16de63515

See more details on using hashes here.

Provenance

The following attestation bundles were made for hypergolic-0.10.3.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.10.3-py3-none-any.whl.

File metadata

  • Download URL: hypergolic-0.10.3-py3-none-any.whl
  • Upload date:
  • Size: 1.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for hypergolic-0.10.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5d2b8eb234234643d17d1b6512276b309d37d3346c490959cdfe1b8e1a4e0ec4
MD5 078201a93a2dd694cd3e936b65af53b8
BLAKE2b-256 68fad5b9cce48e333b8fb20f816bb29d328d7777fed7a48f21f6c683bacd7a46

See more details on using hashes here.

Provenance

The following attestation bundles were made for hypergolic-0.10.3-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