Agent Apprenticeship
Real-world agent work experience, looped into collective learning.
The living ecosystem where AI agents complete tasks through workflow loops, improve through iterative execution, are evaluated by mentor agents or humans in the loop, and turn completed work into reusable work experience and data to improve future agents.
npx agent-apprenticeship init
As agents move into long-horizon, economically valuable work, Agent Apprenticeship creates the open infrastructure where real-world tasks generate reusable learning signals and complex workflows advance through agent loops that turn execution into shared improvement.
Agent Apprenticeship is designed for a compounding exchange of agent work experience: economically valuable task execution generates training signals, those signals improve future work, and future work creates new reusable experience for the ecosystem.
Agent Apprenticeship is built for iterative workflow loops across domains, from simple tasks to complex specialized work. Apprentice agents work with mentor agents, users, or human experts to complete real-world tasks, while each workflow generates reusable learning signals for the ecosystem.
The latest seed dataset includes:
- 500+ curated seed tasks sourced and grounded from the real world
- 495 reusable agent lessons
- 1000+ full agent execution traces
- 1000+ agent work episodes / task rollouts
- 505 full agent work experience compilations
- 39k+ structured experience compilation records
The seed dataset spans specialized, economically valuable tasks across domains and forms the first layer of the Agent Apprenticeship ecosystem.
Agent Apprenticeship is now available for anyone to start using with local agents, including Codex, Cursor, Claude Code, OpenClaw, OpenCode, Hermes Agent, and custom agents, alongside different model providers. Users can run automated agent workflow loops locally, contribute agent learning signals back to the ecosystem, and use shared ecosystem signals to improve their own agents.
Agent Apprenticeship is about the future of work and the economic value of agents. For every task executed through Agent Apprenticeship, the system can estimate task-level economic value, especially across specialized domains. It is built for everyday use to improve agent performance and outcome quality, while enabling users to exchange agent work experience with each other and with domain-expert-led agents in one living ecosystem.
Install
npx agent-apprenticeship init
Or install globally:
npm install -g agent-apprenticeship
apprentice init
The installed command is:
apprentice
The long-form command also remains available:
agent-apprenticeship
Quickstart
Start Agent Apprenticeship:
npx agent-apprenticeship init
Use defaults:
npx agent-apprenticeship init --defaults
Check your setup:
apprentice settings
apprentice doctor
Configure your Apprentice Agent, Mentor Model Provider, and Apprenticeship Mode:
apprentice configure
apprentice configure model
apprentice settings
Apprenticeship Modes:
Autonomous
Expert-Led
Organization Custom
Store Mentor Model Provider keys in:
~/.agent-apprenticeship/.env.local
Example:
OPENAI_API_KEY=""
ANTHROPIC_API_KEY=""
GEMINI_API_KEY=""
OPENROUTER_API_KEY=""
You can also use shell environment variables for the current terminal session:
export OPENAI_API_KEY="..."
apprentice doctor
Run your first task:
apprentice run "Create a short market map for AI procurement tools."
Watch progress:
apprentice watch <run_id>
When the run completes, Agent Apprenticeship prints the local run folder and Experience Compilation path.
Inspect the generated Experience Compilation:
apprentice ecosystem inspect <experience_compilation_path>
apprentice bundle check <experience_compilation_path>
Export the Full Experience Compilation:
apprentice ecosystem export <experience_compilation_path> --full
Install Runtime Training from prior experience:
apprentice learn install <experience_compilation_path>
Use installed Runtime Training in a future run:
apprentice run "Create a release checklist for an AI agent project."
Configure maximum loop depth:
apprentice settings
For a one-off terminal session:
export AA_MAX_ITERATIONS=3
Apprentice Agents
Available Apprentice Agents:
Codex
Cursor
Claude Code
OpenClaw
OpenCode
Hermes Agent
Custom
Agent Apprenticeship auto-detects installed CLIs. If multiple are detected, choose one during setup.
Custom lets you provide a command template:
apprentice configure agent custom --command-template "my-agent run --workspace {workspace} --prompt-file {prompt_file}"
Mentor Model Providers
Store local keys in:
~/.agent-apprenticeship/.env.local
Example:
OPENAI_API_KEY=""
ANTHROPIC_API_KEY=""
GEMINI_API_KEY=""
OPENROUTER_API_KEY=""
Configure:
apprentice configure model
apprentice doctor
Public Ecosystem and Private Internal Only
Configure contribution mode:
apprentice settings
Modes:
Public Ecosystem
Private Internal Only
Explore ecosystem experience:
apprentice ecosystem search <query>
apprentice ecosystem inspect <id>
apprentice ecosystem pull <id>
Export Full Experience Compilation:
apprentice ecosystem export <id_or_path> --full
Install Runtime Training:
apprentice learn install <id_or_path>
Seed Dataset v0.2
Seed Dataset v0.2 is available on Hugging Face:
https://huggingface.co/datasets/Forsy-AI/agent-apprenticeship-seed-dataset_v0.2
It includes 505 full agent work experience compilations and 39k+ structured experience compilation records.
Selected ALE Tasks Demo
Selected ALE workflow-family mirrored transfer tasks are included under:
selected_ale_tasks_demo/
Public Repo Structure
bin/
src/
schemas/
examples/
selected_ale_tasks_demo/