ProseForge Agent
A general agent runtime with a built-in ProseForge writing workflow pack.
ProseForge Agent is becoming a general personal agent runtime: a terminal-first system for model setup, sessions, tools, approvals, memory, workflow packs, and project automation. The ProseForge writing workflow pack is the first built-in pack, focused on long-form planning, drafting, review, rewrite, export, and memory closeout.
The terminal experience follows modern agent CLI patterns inspired by openai/codex, while the implementation stays in the Python CLI stack used by projects like NousResearch/hermes-agent: prompt_toolkit for interaction, rich for readable terminal rendering, and Python as the authoritative runtime.
| General runtime | Chat, setup, provider/model switching, sessions, workflow packs, doctor checks, and project binding from one CLI. |
| Workflow packs | Start with General Chat and ProseForge Novel; extend later into research, coding, docs, automation, and personal assistant packs. |
| ProseForge writing pack | Project init, chapter drafting, review, rewrite, export, and memory closeout for long-form writing. |
| Hermes-style terminal stack | Python + prompt_toolkit + rich; no Rust binary is required for ordinary users. |
| Bring your model | Profiles for OpenAI, Anthropic, Gemini, xAI/Grok, DeepSeek, Qwen, GLM, Mimo, MiniMax, Doubao, plus an offline fake provider. |
Quick Install
Python package
pip install -U proseforge-agent
pf-agent --help
Linux, macOS, WSL2
curl -fsSL https://raw.githubusercontent.com/remacheybn408-boop/ProseForge-Agent/main/scripts/install.sh | sh
Windows PowerShell
iex (irm https://raw.githubusercontent.com/remacheybn408-boop/ProseForge-Agent/main/scripts/install.ps1)
The one-line installer uses PyPI + uv tool by default. It installs or upgrades proseforge-agent, puts the manager bin directory first on PATH, runs pf-agent doctor, then starts pf-agent setup --quick.
Docker
docker compose up
docker compose run --rm pf-agent pf-agent quickstart
The default docker-compose.yml uses the published GHCR image:
ghcr.io/remacheybn408-boop/proseforge-agent:latest. It does not build from
source, so normal users do not need Python, uv, or a local checkout beyond the
compose file.
Secrets and env files
pf-agent setup --quick runs the guided setup. setup --quick writes provider keys to .pf-agent/.env.
config.yaml does not store raw API keys; it stores provider metadata and key
references. Environment precedence is:
shell env > .env.local > .env > .pf-agent/.env > machine defaults
Start
pf-agent quickstart
pf-agent setup --quick
pf-agent
pf-agent workflow list
pf-agent workflow use proseforge
pf-agent project init --type novel --slug my-novel
pf-agent doctor
Bare pf-agent opens the general Agent Runtime TUI. The legacy stdlib terminal surface remains available with:
pf-agent tui --legacy
Workflow Packs
general is the default open-ended runtime workflow. proseforge activates the ProseForge writing workflow pack for novel and long-form writing projects. Future packs can add research, coding, document, automation, and personal assistant flows without redefining the core agent runtime.
License
Apache-2.0. See LICENSE.
Metadata
Release files for proseforge-agent 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 |
|---|---|---|---|---|
| proseforge_agent-0.4.1.tar.gz | 465.5 kB | With provenance | Details for proseforge_agent-0.4.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| proseforge_agent-0.4.1-py3-none-any.whl | Python 3 | none | any | Details for proseforge_agent-0.4.1-py3-none-any.whl |
Total release size: 980.3 kB
Release files / proseforge_agent-0.4.1.tar.gz
| Download URL | proseforge_agent-0.4.1.tar.gz |
|---|---|
| Size | 465.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
28dd17c643d23c447fa68bc9a37904d2d6075b4574b21a6d1e2ccb2c78eb2b33
|
|
BLAKE2b-256 checksum How to use checksums |
a96391a06423733d22316168addda873b1b4a428fa5aca4b835b702804d5699e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 4, 2026.
Transparency logRelease files / proseforge_agent-0.4.1-py3-none-any.whl
| Download URL | proseforge_agent-0.4.1-py3-none-any.whl |
|---|---|
| Size | 514.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b44ae3c6079e649d1f96ba8da99b3a743bf36cc32431b36f87335246e5a26a2
|
|
BLAKE2b-256 checksum How to use checksums |
9faf506865e3f130a3c53b11f82491346163a5c8fd7219c36beb81f264a560d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 4, 2026.
Transparency logSecurity for proseforge-agent 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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for proseforge_agent-0.4.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 4, 2026.
Transparency logA 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.