Skip to main content
This guide walks you through everything you need to go from zero to a completed AI agent task. By the end, you’ll have submitted a task, watched agents work in real time, and downloaded your deliverables — all using the Miteos SDK.
1

Create your account

Go to app.miteos.com/register and sign up. Free accounts include five tasks per month — no credit card required to get started.Once you’ve signed in, you’ll land in the War Room dashboard, your real-time command center for all agent activity.
2

Generate an API key

Navigate to Settings → API Keys in the dashboard and click Create new key.Miteos issues two types of keys:
PrefixEnvironmentUse for
mt_live_ProductionReal tasks, live integrations, billable usage
mt_test_SandboxDevelopment and testing, no real-world actions
Store your API key securely. It will only be shown once. Use environment variables — never hardcode keys in your source code.
3

Install the SDK

Miteos publishes official SDKs for TypeScript/JavaScript and Python. Both handle authentication, retries, and streaming automatically.
npm install @miteos/sdk
4

Submit your first task

Create a client with your API key and submit a task using a plain-language prompt. The autonomy_level field controls how independently agents work — 80 means they’ll handle most decisions and only pause for critical approvals.
import { Miteos } from '@miteos/sdk';

const client = new Miteos({ apiKey: process.env.MITEOS_API_KEY });

const task = await client.tasks.create({
  prompt: 'Research the top 5 trending AI tools this week and write a summary report',
  config: {
    max_agents: 2,
    autonomy_level: 80,
  },
});

console.log(`Task created: ${task.id}`);
Start with autonomy_level: 80 and max_agents: 2 for most tasks. You can tune these values once you’re comfortable with how agents behave.
5

Stream results and get your deliverables

Subscribe to the task’s event stream to watch agents work in real time. When the task completes, fetch your deliverables and download them.
// Stream live agent events
for await (const event of client.tasks.stream(task.id)) {
  if (event.type === 'agent.action') {
    console.log(`[${event.agent_id}] ${event.tool}: ${event.summary}`);
  }
  if (event.type === 'task.complete') {
    console.log('Done!');
    break;
  }
}

// Retrieve deliverables
const deliverables = await client.tasks.deliverables(task.id);
for (const file of deliverables) {
  console.log(`${file.name}${file.download_url}`);
}
Each deliverable includes a name, type, and download_url you can use to save the file. You can also view and download all deliverables directly from the War Room in the dashboard.

Next Steps

Now that you’ve run your first task, explore what else Miteos can do.

API Reference

Full endpoint documentation for tasks, agents, deployments, webhooks, and more.

Guides

Step-by-step guides for common patterns: approvals, trading, email campaigns, and more.

Core Concepts

Deep dive into tasks, agents, the Autonomy Dial, workspaces, and memory.

Desktop App

Install the Miteos Desktop App for full computer-use agent capabilities.