Skip to content

Repository files navigation

Forge 3.0

CI Release

Forge 3.0 is a desktop prompt workshop presented as a focused chat application. Describe a goal, receive a complete ready-to-run system prompt, then keep revising the same draft through normal conversation.

This release replaces the terminal interface with a native desktop window and a saved-chat rail. The Forge drafting engine remains the mouth behind the UI.

Forge 3.0 chat interface

Download

The latest release contains:

Platform File
Windows x64 Forge-3.0-windows-x64.exe
Linux x64 Forge-3.0-linux-x64
macOS Apple Silicon Forge-3.0-macos-arm64
macOS Intel Forge-3.0-macos-x64

SHA-256 checksums are published as SHA256SUMS.txt beside every release.

What changed in 3.0

  • Full chat layout with streaming responses and Markdown rendering
  • Saved workshop threads with rename, search, reopen, and delete
  • Model picker covering OpenRouter, Orca, xAI, and local providers
  • Separate Forge configuration and encrypted local chat history
  • Stronger PURPOSE / ROLE / TASK / OUTPUT prompt compilation
  • Refusal recovery and document-continuation retry rails
  • Native Windows, Linux, Apple Silicon macOS, and Intel macOS builds

Run from source

Python 3.10 or newer is required.

git clone https://github.com/twaai/forge.git
cd forge
python -m venv .venv

Windows:

.venv\Scripts\python -m pip install -r requirements.txt
.\forge.bat

Linux / macOS:

.venv/bin/python -m pip install -r requirements.txt
./forge.sh

On Linux, install either the GTK WebKit runtime or PyQt before launching. The release binary includes the Qt backend.

Local data

Forge stores chats, model selection, and generated history keys under ~/.forge-3. Provider API keys are read from the shared local FORGE 3.0 key directory or environment variables. Credentials and chat history are never stored in this repository.

Development

python -m pytest forge3/tests -q
python -m ruff check --select E9,F63,F7,F82 .
pyinstaller --clean --noconfirm forge.spec

Cross-platform builds are produced by .github/workflows/release.yml from a version tag. CI tests the same chat engine on Windows, Linux, and macOS.

Maintainer

Created and maintained by twaai.

License

Copyright 2026 twaai. See LICENSE and NOTICE.

About

Chat-mode forge for persona-layer system prompts — live model picker, per-target learning, any OpenAI-compatible backend. Cross-platform.

Resources

Contributing

Security policy

Stars

49 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages