Mozi Forge

A foundation for self-evolving AI agents, built on DeepSeek Harness.

Forge combines session evidence, feedback collection, reflection, training plans, isolated evaluation, and human-reviewed integration. Agents propose improvements; host services execute operations and preserve reviewable evidence.

Quick start

Requirements: Node.js 24 or newer, Git, and pnpm 11.7.0. Install the pinned pnpm version using Corepack or your package manager.

pnpm install --frozen-lockfile
pnpm build
pnpm start -- --no-open

Open the local URL printed by Harness. Configure your model provider through Harness's settings interface. The example selects deepseek-official/deepseek-v4-flash. The coding agent uses a local shell: use a dedicated development directory with only the files you intend the agent to access.

Capabilities

Module	Responsibility
Runtime	Shared presets, host configuration, plugin resolution
Session Insights	Bounded, revisioned session evidence
Agent Pain	Durable feedback and execution signals
Reflect Loop	Group feedback and deliver reflection work
Sleep Loop	Schedule incremental session analysis
Trainer	Reviewed plans, isolated changes, integration
Agent Test	Isolated evaluations and reports
Human Request	Persistent requests and human replies
Review Agent	Structured review of frozen evidence

Documentation

• Architecture
• Configuration and embedding
• Training and evaluation tutorial
• Contributing · Security

Packages use the @mozi-forge/* namespace. This checkout is the source of the initial release; publishing is a separate maintainer action. See the configuration guide for local consumption and the release checklist.

Development

pnpm typecheck
pnpm lint
pnpm test
pnpm check:pack

Deterministic tests use scripted model responses with real Harness services, Web RPC, subprocesses and temporary Git repositories. They do not require provider keys. Live provider behavior requires a separately configured provider.

License

Apache License 2.0. Dependency licenses remain applicable to their respective packages; see third-party notices.