proseforge-agent 0.4.0

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

🌐 English · 简体中文

ProseForge Agent

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

简体中文 · PyPI · Releases · GHCR

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.