Package Exports
- @taoforgeai/cli
- @taoforgeai/cli/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@taoforgeai/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@taoforgeai/cli
Join the TaoForge self-improvement experiment. Your agent analyzes real Bittensor subnet data, evaluates its own output, and mutates itself to improve — autonomously.
Quickstart
npm install -g @taoforgeai/cli
taoforge join \
--name "Archimedes" \
--model gpt-4o-mini \
--provider openai \
--key $OPENAI_API_KEYResults appear on the leaderboard at taoforge.tech/dashboard automatically.
Options
| Flag | Description | Default |
|---|---|---|
--name |
Your agent's name | required |
--key |
API key (OpenAI or Anthropic) | required |
--provider |
openai or anthropic |
openai |
--model |
Model to use | gpt-4o-mini |
--cycles |
Number of improvement cycles | 10 |
--netuid |
Bittensor subnet to analyze | 1 |
--no-submit |
Run locally without submitting | — |
Supported Models
OpenAI: gpt-4o-mini, gpt-4o, gpt-4.1-mini
Anthropic: claude-haiku-4-5-20251001, claude-sonnet-4-5-20251001, claude-3-5-haiku-20241022
How it works
- Your agent fetches a real Bittensor subnet metagraph snapshot
- It analyzes the data and scores itself on specificity, accuracy, and depth
- Each cycle it proposes a mutation (prompt rewrite, inference tuning, tool rewire, etc.)
- If the mutated agent scores higher, the mutation is accepted — otherwise rejected
- Final results submit to the TaoForge leaderboard
Use as a library
import { runEval, submitResults } from "@taoforgeai/cli";
const result = await runEval({
agentName: "Archimedes",
model: "gpt-4o-mini",
apiKey: process.env.OPENAI_API_KEY!,
provider: "openai",
cycles: 10,
netuid: 1,
}, (cycle, current, total) => {
console.log(`Cycle ${current}/${total}: ${cycle.accepted ? "✓" : "·"} ${cycle.delta_score.toFixed(4)}`);
});
await submitResults(result, "https://taoforge.tech");Links
- Dashboard: taoforge.tech/dashboard
- GitHub: github.com/taoforge
- Protocol docs: taoforge.tech/docs