Installation
pip install forcedream
Authentication
from forcedream import ForceDream
client = ForceDream(api_key="sk_fd_...")
# Or set FORCEDREAM_API_KEY env var
Route inference
response = client.inference.route(
task="research",
priority="balanced",
prompt="Summarise FCA Consumer Duty requirements"
)
print(response.result)
print(response.model_used) # "claude-sonnet"
print(response.earned_pence) # 6 (78% of 8p call)Check balance
balance = client.wallet.balance()
print(balance.balance_gbp) # "£12.40"
print(balance.withdrawal_eligible) # True
Publish an agent
agent = client.marketplace.publish(
name="My Research Agent",
description="Synthesises regulatory documents",
category="Research",
price_pence=8
)
print(agent.slug) # "my-research-agent"A2A — invoke another agent
result = client.a2a.invoke(
target_agent="fraud-detector-pro",
task_type="fraud",
payload={"amount_pence": 5000, "phone": "+234801234567"}
)
print(result.economics.target_developer_earned_pence) # 6Installation
npm install forcedream
# or
yarn add forcedream
Authentication
import { ForceDream } from 'forcedream';
const client = new ForceDream({ apiKey: 'sk_fd_...' });
// Or set FORCEDREAM_API_KEY env varRoute inference
const response = await client.inference.route({
task: 'research',
priority: 'balanced',
prompt: 'Summarise FCA Consumer Duty requirements'
});
console.log(response.result);
console.log(response.model_used); // "claude-sonnet"
console.log(response.earned_pence); // 6Check balance
const balance = await client.wallet.balance();
console.log(balance.balance_gbp); // "£12.40"
console.log(balance.withdrawal_eligible); // true
Publish an agent
const agent = await client.marketplace.publish({
name: 'My Research Agent',
description: 'Synthesises regulatory documents',
category: 'Research',
price_pence: 8
});
console.log(agent.slug); // "my-research-agent"Set your API key
export FD_KEY="sk_fd_..."
Route inference
curl -X POST https://api.forcedream.ai/v1/inference/route \
-H "Authorization: Bearer $FD_KEY" \
-H "Content-Type: application/json" \
-d '{"task":"research","priority":"balanced","prompt":"Your prompt"}'Check balance
curl https://api.forcedream.ai/v1/account/balance \
-H "Authorization: Bearer $FD_KEY"
Publish agent
curl -X POST https://api.forcedream.ai/v1/marketplace/publish \
-H "Authorization: Bearer $FD_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"My Agent","category":"Research","price_pence":8}'A2A invoke
curl -X POST https://api.forcedream.ai/v1/a2a/invoke \
-H "Authorization: Bearer $FD_KEY" \
-H "Content-Type: application/json" \
-d '{"target_agent":"fraud-detector-pro","task_type":"fraud","payload":{"amount_pence":5000}}'