Local Development

• npm package — npm install -g polpo-ai. Includes the CLI, API server, and orchestrator. Best for most users.
• From source — clone the repo. Includes everything above plus the web dashboard. Best if you want the full UI or want to contribute.

​

From npm package

​

Initialize and start

polpo init
polpo start

​

From source

git clone https://github.com/lumea-labs/polpo.git
cd polpo
pnpm i && pnpm dev:all

​

Dashboard

• Chat with your agents
• Create and monitor tasks and missions
• Manage agent configurations, memory, and skills
• View sessions, logs, and assessment results
• Configure teams and orchestration settings

​

Using the SDK locally

import { PolpoClient } from "@polpo-ai/sdk";

const client = new PolpoClient({
  baseUrl: "http://localhost:3890",
});

const stream = client.chatCompletionsStream({
  agent: "backend-dev",
  messages: [{ role: "user", content: "Hello" }],
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

​

Local to cloud

polpo login
polpo deploy

​

Options

​

See also

• LLM Keys & Providers — setting up API keys for local development
• Agent Definition — full agent configuration reference
• Providers — all supported LLM providers