Build an Iztro Agent

Start new integrations with the Iztro Agents SDK and an Iztro Session. The SDK lets your agent keep durable conversation memory while Iztro provides the hosted Ziwei and Qimen models.

• Choose iztro-ziwei-v3 for natal charts, compatibility, and longer-term fortune cycles.
• Choose iztro-qimen-v3 for one concrete, time-sensitive decision and optional timing. It uses the question time and needs no birth details. Compare both options in Models.

Choose an integration path

1. Agent SDK (recommended) — Python or TypeScript agent applications with Iztro Session, local tools, MCP, and human approval.
2. HTTP API — use Chat API for stateless calls or Session API for managed conversations.

Before you start

• Create an API key in the Iztro Console.
• Keep the key on your server. Do not expose it in browser code.
• Choose SDK quickstart for a new integration. It already includes ChatSession and streaming; use ChatSession management for lifecycle operations.
• Read Models before writing prompts so each request uses the correct model and input.
• To build a browser, backend, and database together, continue with the full-stack application tutorial.