Agentic-Org

Prerequisites

• Python 3.11+ (tested on 3.12, 3.13) | Node.js 20+ | Docker

Install Python dependencies

pip install -r requirements.txt # Core platform (required) pip install -r requirements-v4.txt # v4 features (optional) pip install -r requirements-dev.txt # Dev tools (optional)

NL Workflow Builder

Describe business processes in plain English (e.g., "Automate invoice approval when amount > 5L") and the system generates the complete workflow definition. Preview before deploying.

Installation

AgenticOrg provides three requirements files for different deployment scenarios:

All versions in requirements.txt are pinned to exact production-tested versions (2026-04-06).

Optional Docker Services

docker compose --profile ragflow up -d       # Knowledge Base (RAGFlow)
docker compose --profile voice up -d         # Voice Agents (LiveKit)
docker compose --profile airgap up -d        # Local LLM (Ollama, CPU)
docker compose --profile airgap-gpu up -d    # Local LLM (vLLM, GPU)

Docker Compose

```bash docker compose up -d

Build/push and roll out origin/main with revision health checks.

bash scripts/deploy_cloud_run.sh --yes

Deploy an already-built commit image and run migrations before traffic moves.

bash scripts/deploy_cloud_run.sh --sha <commit-sha> --skip-build --with-migrations --yes

Latest commerce/deploy/security guards

python -m pytest tests/unit/test_oacp_c6x4_durable_cache_repository.py tests/unit/test_oacp_c6x5_cache_maintenance.py tests/unit/test_deploy_cloud_run_script.py tests/regression/test_security_audit_20260613_dependency_gates.py -q

Quick Start

Demo Credentials

---

Environment Variables

COMPOSIO_API_KEY              — 1000+ tool integrations (optional)
AGENTICORG_LLM_ROUTING        — auto | tier1 | tier2 | tier3 | disabled
AGENTICORG_LLM_MODE           — cloud | local | auto
AGENTICORG_PII_REDACTION_MODE — before_llm | logs_only | disabled
RAGFLOW_API_URL               — RAGFlow instance URL for knowledge base
RAGFLOW_API_KEY               — RAGFlow API key
LIVEKIT_URL                   — LiveKit server URL for voice agents
LIVEKIT_API_KEY               — LiveKit API key
LIVEKIT_API_SECRET            — LiveKit API secret
STRIPE_SECRET_KEY             — Stripe billing key (hosted tier)
STRIPE_WEBHOOK_SECRET         — Stripe webhook signing secret

NL Query Interface

Natural language search across all your business data: - Cmd+K Search Bar — global shortcut opens search from any page - Slide-out Chat Panel — full conversational interface with agent attribution - Agent Attribution — every answer shows which agent(s) provided the data - Example Queries: "What's my cash position?", "Show me AP aging over 90 days", "How did Google Ads perform last week?", "What's our DSO this quarter?"

Native Enterprise Connectors — All Real API Endpoints

Finance (11): Oracle Fusion, SAP, Tally (XML/TDL + bridge), GSTN (Adaequare 2-step + DSC), Stripe, QuickBooks, Zoho Books, Banking AA (RBI consent), Income Tax India, Pine Labs (Plural), NetSuite HR (8): Darwinbox, Okta, Greenhouse, LinkedIn Talent, DocuSign, Keka, Zoom, EPFO Marketing (19): Salesforce, HubSpot, Google Ads, LinkedIn Ads, Meta Ads, Ahrefs, Mixpanel, Buffer, Brandwatch, GA4, MoEngage, WordPress, Twitter/X, YouTube, Mailchimp, Semrush, Bombora, G2, TrustRadius Ops (7): Jira, ServiceNow, Zendesk, PagerDuty, Confluence, Sanctions API, MCA Portal Comms (9): Slack, GitHub, Gmail, SendGrid, GCS, Google Calendar, Twilio, WhatsApp, LangSmith

Every connector uses real API endpoints from official documentation. Zero stubs. The Tally connector uses native XML/TDL protocol with a bridge agent for on-premise instances. Banking AA follows RBI-compliant consent flow. GSTN uses Adaequare's 2-step authentication with DSC signing for filing.

Run API server

uvicorn api.main:app --host 0.0.0.0 --port 8000 --reload

API: http://localhost:8000 | UI: http://localhost:3000

```

API Reference

Base URL: https://app.agenticorg.ai/api/v1

SDKs, CLI & MCP Server

pip install agenticorg is the canonical Python install path for both the SDK and the direct agenticorg CLI. Use the CLI from shell-capable assistants and developer environments such as Claude Code, Codex, Gemini CLI, VS Code tasks/terminals, CI jobs, and customer runbooks. Use the MCP server when the client supports Model Context Protocol and should call AgenticOrg as tools.

Python SDK

pip install agenticorg

from agenticorg import AgenticOrg

client = AgenticOrg(api_key="ao_sk_your_key_here")
result = client.agents.run("ap_processor", inputs={"invoice_id": "INV-001"})
agents = client.agents.list()
commerce = client.agents.run(
    "commerce_sales_agent",
    action="buyer_discovery_preview",
    inputs={"merchant_id": "merchant_demo", "query": "Show laptops under Rs 50000"},
)
draft_agent = client.agents.generate("Create a contract intelligence agent using Confluence and Jira")
kb = client.knowledge.search("vendor renewal policy", top_k=3)
workflow_draft = client.workflows.generate("Review vendor renewal risk using KB and Jira, then notify vendor_manager")
workflow = client.workflows.create(name="Renewal Risk Review", definition=workflow_draft["workflow"], domain="ops")
run = client.workflows.run(workflow["id"], payload={"vendor_id": "V-100"})
sop = client.sop.parse_text("When invoice > 5L, require CFO approval")
card = client.a2a.agent_card()

TypeScript SDK

npm install agenticorg-sdk

import { AgenticOrg } from "agenticorg-sdk";

const client = new AgenticOrg({ apiKey: "ao_sk_your_key_here" });
const result = await client.agents.run("ap_processor", { inputs: { invoice_id: "INV-001" } });
const commerce = await client.agents.run("commerce_sales_agent", {
  action: "buyer_discovery_preview",
  inputs: { merchant_id: "merchant_demo", query: "Show laptops under Rs 50000" },
});
const draftAgent = await client.agents.generate("Create a contract intelligence agent using Confluence and Jira");
const kb = await client.knowledge.search("vendor renewal policy", { topK: 3 });
const workflowDraft = await client.workflows.generate("Review vendor renewal risk using KB and Jira, then notify vendor_manager");
const agents = await client.agents.list();

API Keys

API keys provide programmatic access for SDKs, CLI, and MCP integrations.

• Prefix: All keys use the ao_sk_ prefix (e.g., ao_sk_a1b2c3...)
• Generation: Admin users generate keys from Settings > API Keys in the app, or via POST /api/v1/org/api-keys
• Admin-only: API key endpoints require the agenticorg:admin scope
• Security: Keys are bcrypt-hashed at rest; the full key is shown only once at creation
• Revocation: Keys can be revoked instantly from Settings or via DELETE /api/v1/org/api-keys/{id}

---

Production connector test — real Jira/HubSpot/GitHub API calls

python tests/test_production_connectors.py ```

---

Workflow Templates (15 Pre-built)

Production-ready workflow templates that combine multiple agents: <div class="rdm-tbl-wrap"><table class="rdm-tbl"><thead><tr><th>Template</th><th>Domain</th><th>Description</th></tr></thead><tbody><tr><td>invoice_to_pay_v3</td><td>Finance</td><td>PDF parse --&gt; GSTIN --&gt; 3-way match --&gt; payment execution</td></tr><tr><td>month_end_close</td><td>Finance</td><td>Trial balance --&gt; adjustments --&gt; reconciliation --&gt; close</td></tr><tr><td>daily_treasury</td><td>Finance</td><td>Cash position --&gt; sweep --&gt; forecast --&gt; report</td></tr><tr><td>tax_calendar</td><td>Finance</td><td>Deadline tracking --&gt; filing prep --&gt; DSC signing</td></tr><tr><td>campaign_launch</td><td>Marketing</td><td>Brief --&gt; content --&gt; review --&gt; publish --&gt; monitor</td></tr><tr><td>content_pipeline</td><td>Marketing</td><td>Ideation --&gt; draft --&gt; SEO --&gt; approval --&gt; publish</td></tr><tr><td>lead_nurture</td><td>Marketing</td><td>Scoring --&gt; segmentation --&gt; drip --&gt; wait_for_event --&gt; handoff to sales</td></tr><tr><td>weekly_marketing_report</td><td>Marketing</td><td>Collect metrics --&gt; build report --&gt; deliver</td></tr><tr><td>email_drip_sequence</td><td>Marketing</td><td>Behavior-triggered email sequences (open/click/time delays)</td></tr><tr><td>ab_test_campaign</td><td>Marketing</td><td>Create variants --&gt; run test --&gt; auto-winner selection --&gt; CMO override --&gt; send winner</td></tr><tr><td>abm_campaign</td><td>Marketing</td><td>CSV upload targets --&gt; intent scoring (Bombora/G2/TrustRadius) --&gt; personalized outreach</td></tr><tr><td>incident_response</td><td>Ops</td><td>Triage --&gt; Jira ticket --&gt; assign --&gt; monitor --&gt; resolve</td></tr><tr><td>lead_to_revenue</td><td>Sales</td><td>Qualify --&gt; outreach --&gt; follow-up --&gt; close</td></tr><tr><td>weekly_devops_health</td><td>Ops</td><td>GitHub + Jira metrics --&gt; health score --&gt; report</td></tr></tbody></table></div>

Integration Protocols

Integration Workflow Page

The /integration-workflow page provides a visual guide for connecting external systems, with SDK/CLI quickstart examples and protocol documentation.

---