Skip to main content

🌐 English · 简体中文

ProseForge Agent command center

ProseForge Agent

A general agent runtime with a built-in ProseForge writing workflow pack.

简体中文 · PyPI · Releases · GHCR

PyPI version Python versions CI status Apache-2.0 license

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 runtimeChat, setup, provider/model switching, sessions, workflow packs, doctor checks, and project binding from one CLI.
Workflow packsStart with General Chat and ProseForge Novel; extend later into research, coding, docs, automation, and personal assistant packs.
ProseForge writing packProject init, chapter drafting, review, rewrite, export, and memory closeout for long-form writing.
Hermes-style terminal stackPython + prompt_toolkit + rich; no Rust binary is required for ordinary users.
Bring your modelProfiles 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)

Source distribution for proseforge-agent 0.4.1
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)

Table of built distributions (wheels) for proseforge-agent 0.4.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page