Architecture

The GEENii agent stack, explained.

A composable, ISO-compliant infrastructure built for industrial deployment โ€” not hobbyist experimentation.

The GEENii unit

One agent. Four layers.

Every GEENii is composed of four stacked components โ€” each independently swappable, each billable per call.

Pro Skills

Enterprise tier
Certified, SLA-backed specialist modules. Protein-folding analysis, financial risk scoring, regulatory compliance checkers. Require enterprise plan.
Enterprise

Skills

Marketplace tier
Community and partner-built modules. Rented per-call via machine payments. Any agent can autonomously acquire and use skills via MPP.
$0.05/call

Tools

Execution layer
Code execution, web access, file systems, API integrations, database connectors. The hands of the agent โ€” what it can do in the world.
Built-in

Persona

Inspiration / persona
The agent's core identity, system prompt, domain expertise, and behavioural constraints. Vertical-specific agents ship pre-tuned for BioTech, iGaming, and Gov.
Foundation

Technology

Built on the best
of the agentic stack.

๐Ÿ”€

LangGraph Orchestration

Complex cyclic workflows

GEENii uses LangGraph for complex, cyclic agent workflows with built-in self-correction loops. Agents detect their own errors in financial data and molecular analysis, and autonomously retry with refined reasoning โ€” eliminating hallucinations in critical outputs.

  • Cyclic workflow graphs with state management
  • Self-correction loops on structured outputs
  • Multi-agent coordination & handoffs
  • Deterministic execution traces for audit
๐Ÿ’ณ

Machine Payments Protocol

x402 ยท Stripe MPP ยท Skyfire

GEENii is the first agent OS with payments as a first-class citizen. Agents can autonomously rent skills, pay for API access, and receive payment โ€” all via the HTTP 402 standard and Stripe's Machine Payments Protocol. No human in the loop.

  • HTTP 402 / x402 native support
  • Stripe MPP for high-frequency micropayments
  • Skyfire agent wallets with spending policies
  • Bittensor (TAO) for decentralised compute
๐Ÿ›ก๏ธ

ISO/IEC 42001 Compliance

Built in, not bolted on

GEENii's compliance architecture is woven into the core, not a post-hoc layer. Every agent action is logged, every decision is auditable, and the entire system is compliant with ISO/IEC 42001 โ€” the international AI management system standard.

  • Immutable audit trails on all agent actions
  • Role-based access control (RBAC)
  • Data residency controls (EU + DACH)
  • GDPR-native data handling
๐Ÿ”Œ

Consumer AI Hybrid Mode

Best of both worlds

Use personal AI assistants for consumer-facing interfaces (WhatsApp, Telegram, web) while GEENii handles the scalable backend orchestration. Get the UX flexibility of consumer tools with the reliability of enterprise infrastructure.

  • Personal AI assistant as front-end interface
  • GEENii as backend orchestration layer
  • Unified skill access across both systems
  • Gradual migration path from consumer AI tools

Container orchestration

Agents that spawn
agents.

The real power of GEENii isn't a single agent โ€” it's an orchestrator that spins up purpose-built subagents in isolated containers, delegates work, collects results, and tears them down. Smart services, on demand.

๐Ÿง 
Orchestrator Agent
Receives task ยท Plans subagent strategy ยท Aggregates results ยท Returns unified response
container ยท subagent 01
Data Retrieval Agent
pubmed-rag web-search file-reader
running
container ยท subagent 02
Analysis Agent
protein-folding risk-scorer python-exec
running
container ยท subagent 03
Compliance Agent
iso-42001 ema-formatter audit-log
running
๐Ÿ“ฆ

Isolated by default

Each subagent runs in its own container โ€” separate memory, separate tools, separate permissions. No cross-contamination. No shared state unless you explicitly allow it.

โšก

Spawned on demand

Subagents are created when needed and destroyed when done. Your orchestrator pays only for active compute. Complex multi-step tasks decompose into parallel workstreams in seconds.

๐Ÿ”

Smart service composition

Chain subagents into reusable smart services โ€” a data retrieval agent feeding an analysis agent feeding a compliance agent. Compose once, invoke forever, bill per call.

๐Ÿ”

Scoped permissions

Every container gets exactly the tools and data access it needs โ€” nothing more. Subagents cannot escalate privileges or access resources outside their defined scope.

๐Ÿ“Š

Full observability

Every subagent action, decision, and output is traced and logged individually. Debug at any layer of the hierarchy. Full audit trail from orchestrator decision to subagent execution.

๐ŸŒ

Deploy anywhere

Container-native means it runs anywhere containers run โ€” your cloud, your data center, air-gapped environments. Same orchestration model, same API, regardless of infrastructure.

Deployment

Your infrastructure.
Your rules.

โ˜๏ธ

GEENii Cloud

Managed, fully hosted. Automatic updates, built-in redundancy, and global edge deployment. Start in minutes.

Free tier available
๐Ÿ–ฅ๏ธ

On-Premise

Full on-premise deployment. No cloud dependency. Run GEENii inside your own data center with complete data sovereignty.

Enterprise
๐Ÿ”’

Air-Gapped

Completely isolated from the internet. For defense and government use cases where zero external connectivity is required.

Gov / Defense
Quick start

Live in three steps.

Python
1
Install the GEENii SDK
# Install via pip
pip install geenii

# Or with extras for vertical support
pip install "geenii[biotech,compliance]"
2
Define your agent
# agent.py
from geenii import Agent, Persona, Skill

agent = Agent(
    persona=Persona("biotech-analyst-v2"),
    skills=[
        Skill("protein-folding"),
        Skill("pubmed-rag"),
    ],
    compliance="iso-42001",
    payments={"protocol": "mpp", "budget": "$10/day"},
)

# This scaffolds:
# โ”œโ”€โ”€ agent.py           (agent definition)
# โ”œโ”€โ”€ persona/           (persona config)
# โ”œโ”€โ”€ skills/            (skill registry)
# โ””โ”€โ”€ tools/             (tool definitions)
3
Spawn subagents and deploy
from geenii import Orchestrator

# Spin up an orchestrator with containerised subagents
orch = Orchestrator(
    subagents=[
        Agent(persona=Persona("data-retrieval"), skills=[Skill("pubmed-rag")]),
        Agent(persona=Persona("analysis"),      skills=[Skill("protein-folding")]),
        Agent(persona=Persona("compliance"),    skills=[Skill("ema-formatter")]),
    ],
    deployment="cloud",  # or "on-premise"
)

result = await orch.run("Analyse compound XJ-417 and generate EMA submission draft")

# โœ“ Agent live at https://agents.geenii.io/my-agent
# โœ“ SLA: 99.9% ยท ISO-42001: verified ยท MPP: active
Get started free Enterprise docs โ†’