Developer Hub

Build with the octopus.

Open source SDKs, comprehensive API, and a community of developers building sovereign AI agents. Contribute a tentacle. Fork a pipeline. Shape the future of agent orchestration.

Quickstart → GitHub
# Install the Python SDK
$ pip install polpai

# Run your first agent in 3 lines
from polpai import Octopus

octo = Octopus(api_key="pk_...", storage="byos://my-supabase")
result = await octo.tentacle("deal_hunter").execute(
    query="MacBook Pro M4 under $2000",
    fake_discount_check=True
)

print(result.deals)  # [{product: "MacBook Pro 14", price: 1899, genuine: True}]
print(result.fitness) # 0.91 -- agent confidence score
Open Source

Repositories

Core engine and SDKs. Fork, contribute, build custom tentacles.

polpai-core Python

The IABROKER engine. 139 agents, pipeline orchestration, Darwinian evolution, structural guardrails. The brain of the octopus.

356 endpoints54 patent familiesMIT License

polpai-sdk-python Python

Python SDK for the PolpAI API. Async-first, typed, with full tentacle and pipeline support. pip install polpai.

PyPI: polpaiAsync/awaitTyped

polpai-sdk-ts TypeScript

TypeScript/JavaScript SDK. Works in Node.js, Deno, Bun, and browsers. npm install @polpai/sdk.

npm: @polpai/sdkESM + CJSTree-shakeable

polpai-sdk-go Go

Go client for PolpAI. Lightweight, zero dependencies, context-aware. go get github.com/polpai/sdk-go.

Go 1.22+Zero depsContext-aware

polpai-mnemo Rust

MNEMO sovereign memory engine. Zero-knowledge storage, AES-256-GCM, W3C DIDs. The memory layer for MonIAaMoi.

Tauri 2.0WASM readyZero exfiltration

polpai-tentacle-template Python

Template for building custom tentacles. Includes predict(), evolve(), structural guardrails, and test scaffold.

Cookiecutter5 min setupFull test suite
Technical Blog

Behind the tentacles.

Engineering notes, research, and architecture decisions from the PolpAI team.

February 2026

Why We Built an AI Octopus

You don't have an AI problem. You have an orchestration problem. How octopus neurology inspired our multi-agent architecture.

architecturemulti-agentorigin story
February 2026

Your AI is Watching You

96% of AI agents can be manipulated through prompt injection. Why structural guardrails are the only real defense.

securityOWASP agenticBYOS
Coming soon

Darwinian AI: How Our Agents Evolve

predict() + evolve() + fitness scoring. How PolpAI agents improve themselves without sending your data anywhere.

evolutionfitness scoringresearch
Coming soon

Building a Custom Tentacle in 30 Minutes

Step-by-step tutorial: from polpai-tentacle-template to a deployed, self-evolving agent in your pipeline.

tutorialSDKbeginner
Architecture

How the octopus works.

High-level architecture of the PolpAI agent orchestration platform.

User Request | v [MCP Gateway / REST API] -- polpai.io | v [IABROKER Router] -- Intent classification + agent selection | +--> [Injection Scanner] -- Pre-execution safety | v [Agent Pipeline] |--- T1: Deal Hunter (AlerteRabais) |--- T2: Gift Sensei (TrouveUnCadeau) |--- T3: Wallet Guardian |--- T4: Alpha Radar (Crypto) |--- T5: Doc Agent |--- T6: Personal Shopper (MonAcheteurAI) |--- T7: Automator |--- T8: Nexus Linker | v [Challenge Gate] -- Cryptographic inter-agent verification | v [Reality Anchor] -- Memory integrity check (L5) | v [PII Scrubber + Audit Trail] -- Post-execution cleanup | v [Response] --> User (WhatsApp / Telegram / Web / Email / API) | v [BYOS Storage] -- YOUR Supabase / PostgreSQL / S3 | v [Evolution Engine] -- predict() + evolve() + fitness scoring