🌐 English · 简体中文

ProseForge Agent command center

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

proseforge_agent-0.4.1.tar.gz (465.5 kB view details)

Uploaded Jul 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

proseforge_agent-0.4.1-py3-none-any.whl (514.8 kB view details)

Uploaded Jul 4, 2026 Python 3

File details

Details for the file proseforge_agent-0.4.1.tar.gz.

File metadata

Download URL: proseforge_agent-0.4.1.tar.gz
Upload date: Jul 4, 2026
Size: 465.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for proseforge_agent-0.4.1.tar.gz
Algorithm	Hash digest
SHA256	`28dd17c643d23c447fa68bc9a37904d2d6075b4574b21a6d1e2ccb2c78eb2b33`
MD5	`abac427b66e7ed7f2b7e954f092209dc`
BLAKE2b-256	`a96391a06423733d22316168addda873b1b4a428fa5aca4b835b702804d5699e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for proseforge_agent-0.4.1.tar.gz:

Publisher: release.yml on remacheybn408-boop/ProseForge-Agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: proseforge_agent-0.4.1.tar.gz
- Subject digest: 28dd17c643d23c447fa68bc9a37904d2d6075b4574b21a6d1e2ccb2c78eb2b33
- Sigstore transparency entry: 2067795227
- Sigstore integration time: Jul 4, 2026
Source repository:
- Permalink: remacheybn408-boop/ProseForge-Agent@2410bff2d75251131f5d9a4e9bb159f3f6d3c532
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/remacheybn408-boop
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@2410bff2d75251131f5d9a4e9bb159f3f6d3c532
- Trigger Event: push