Local-first document workspace for grounded answers, citations, memory, and recall practice with any LLM
Project description
Heph
Heph is the agent brain the user talks to.
It owns the user-facing agent identity, research/talking orchestration, the command entrypoint, slash-command coordination, and the composition needed to connect the harness, AI runtime, interfaces, and extension contracts.
Heph is not the validation harness. That is Hephaion.
Source Layout
src/
heph/
cli/ Console entrypoint and top-level command routing
commands/ Slash-command registry and command coordinators
sdk/ Programmatic runtime/session surface for native apps and automation
product/ Temporary bridge for Heph self-knowledge context
identity/ Stable agent identity target
prompts/ Prompt-program target for Heph-facing behavior
state/ Declarative state contract target
The product/ bridge exists for current self-knowledge routing. It should stay
thin and should not become a second harness or a place for domain behavior.
Boundaries
Heph is protected as the brain and composition layer. Lower packages must not import it, and optional behavior should extend Heph through contracts or composition instead of modifying harness or AI internals:
- Heph calls Hephaion for grounded answering, validation, citations, retrieval, memory, and armory workflows.
- Heph calls AI for provider/model runtime.
- Heph calls Interfaces for terminal and TUI presentation.
- Heph calls Extensions for stable extension contracts.
- Heph exposes SDK wrappers for non-terminal clients; those wrappers must stay
UI-neutral and must not import
interfaces.*.
Reusable validation behavior should move to Hephaion. Provider/API behavior should move to AI. Conversational strategy, research orchestration, and Heph-facing identity should stay here or move here as the migration continues.
Development
uv run pytest --no-cov packages/heph/test
uv run heph --help
uv run python -m scripts.check_repo_policies
uv run lint-imports
Related Docs
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 heph-0.0.51.tar.gz.
File metadata
- Download URL: heph-0.0.51.tar.gz
- Upload date:
- Size: 526.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"NixOS","version":"26.05","id":"yarara","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0882e93d07830a00cbc83bd58ac7cc5dac127f3ccd552abe5a14a2cd237d1fc9
|
|
| MD5 |
bfee4ac8518a702c7e53cc9975cda629
|
|
| BLAKE2b-256 |
9eabf739049c55f413ed5a502e5f9fe1a871ca8b5ac519daf6699452800ff738
|
File details
Details for the file heph-0.0.51-py3-none-any.whl.
File metadata
- Download URL: heph-0.0.51-py3-none-any.whl
- Upload date:
- Size: 647.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"NixOS","version":"26.05","id":"yarara","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
50a5c28fe04fc3bd38303c124bb4f39bad917066df258683fa94fc6bd3a97396
|
|
| MD5 |
31f078f12aa56ea174e95d53bc96dc7b
|
|
| BLAKE2b-256 |
f2cde9c9d68616ca7e996d05c466c023e613ae6b9f9e85d1527a96d4c446eb3e
|
