{
  "markdown": "# 🐜 GEIANT\n\n**Geo-Identity Agent Navigation & Tasking**\n\n> *The first AI orchestrator that knows where it is.*\n\n---\n\n## What is GEIANT?\n\nGEIANT is a geospatial AI agent orchestration runtime built on the [GNS Protocol](https://gcrumbs.com). It is a direct competitor to LangChain, CrewAI, and AutoGen — with one structural difference: **every agent has a cryptographic identity bound to an H3 territory, and every task is routed through a compliance enforcement layer before dispatch.**\n\nLangChain doesn't know where it is. GEIANT does.\n\n---\n\n## The Ant Metaphor\n\nIn GEIANT, agents are **ants**. Ants are the canonical model of emergent collective intelligence from simple agents following spatial rules. Ant Colony Optimization (ACO) is a real algorithm used in routing and pathfinding. The colony is the orchestrated workflow. The territory is the H3 grid.\n\n- An **ant** (`AntIdentity`) is an agent with a GNS Ed25519 keypair + H3 territory + facet scope + trust tier\n- The **colony** is a multi-agent workflow where ants delegate and collaborate\n- The **nest** is the Agent Registry — the directory of available ants\n- The **trail** is the Virtual Breadcrumb chain — the Proof-of-Jurisdiction audit log\n\n---\n\n## Architecture\n\n```\nL6  Multi-Agent Orchestration    — task graph, delegation chain enforcement\nL5  IDUP Settlement Layer        — Stellar payment routing per operation  \nL4  MCP GIS Switchboard          — GDAL / PostGIS / ArcGIS / QGIS / EO models\nL3  Perception Layer             — IBM Prithvi, Microsoft Clay (EO Foundation Models)\nL2  Geometry Validation Layer    — GEOS-backed guardrails, self-intersection detection\nL1  Geospatial Router            — H3 jurisdiction matching, TierGate enforcement\nL0  Agent Identity & Registry    — Ed25519 + H3 + GNS-AIP (LIVE in gns-node)\n```\n\n**Phase 0** (this repo): L0 + L1 + L2 core logic, tests, and API scaffold.\n\n---\n\n## Monorepo Structure\n\n```\ngeiant/\n├── packages/\n│   ├── core/          @geiant/core — types, router, validation, registry, jurisdiction\n│   └── sdk/           @geiant/sdk  — developer-facing SDK (Phase 1)\n├── apps/\n│   └── api/           @geiant/api  — Express REST API\n└── docs/              Architecture docs, ADRs\n```\n\n---\n\n## The Four Router Gates\n\nEvery task passes through four gates before any ant is selected:\n\n1. **Signature Verification** — Ed25519 signature over canonical task JSON\n2. **Jurisdiction Resolution** — H3 cell → country → regulatory frameworks (GDPR, EU AI Act, FINMA, CCPA...)\n3. **Delegation Chain Validation** — human GNS identity → delegation cert → scope cells + facets + expiry\n4. **Geometry Pre-flight** — GEOS-backed validation: self-intersection, coordinate transposition, unclosed rings\n\nOnly tasks that pass all four are dispatched. The router is a compliance enforcement point, not a load balancer.\n\n---\n\n## Getting Started\n\n```bash\n# Install dependencies\npnpm install\n\n# Run tests\npnpm test\n\n# Start dev API\npnpm dev\n\n# Test routing endpoint\ncurl http://localhost:3100/health\ncurl http://localhost:3100/registry\ncurl http://localhost:3100/jurisdiction/8728d55ffffffff   # Rome H3 cell\ncurl http://localhost:3100/route/test\n```\n\n---\n\n## Competitive Position\n\n| Feature | LangChain | CrewAI | **GEIANT** |\n|---|---|---|---|\n| Agent identity | API key | API key | Ed25519 GNS keypair |\n| Task routing | Capability + cost | Capability + cost | **H3 jurisdiction + compliance** |\n| Audit trail | Logs | Logs | **Virtual breadcrumbs (crypto)** |\n| Geometry validation | None | None | **Built-in guardrails** |\n| Human accountability | None | None | **Delegation chain** |\n| Regulatory compliance | Manual | Manual | **Proof-of-Jurisdiction** |\n\n---\n\n## Patent & IP\n\nGNS Protocol Provisional Patent #63/948,788 (Proof-of-Trajectory).  \nGEIANT's Proof-of-Jurisdiction is a second patentable claim extending this.\n\n---\n\n## License\n\nProtocol spec: CC-BY  \nCore library: Apache 2.0  \nManaged runtime: Proprietary  \n\nGNS Foundation | Globe Crumbs Inc. | ULISSY s.r.l.  \nVia Gaetano Sacchi 16, 00153 Roma | ulissy@pec.it | gcrumbs.com\n",
  "bytes": 4042,
  "sha": "97bee794e1602ffa005a4152f064e6b7bb9d73017eb109c01997df7cde058f35",
  "repo_slug": "gns-foundation/geiant",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_geiant_mcp_agentcore_f9a9662e/readme"
}