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.