Skip to content

KeyMatrix-solutions/nervemind-cgos-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

NerveMind CGOS Python SDK

AI governance SDK Python fintech enterprise-ai risk-management api client

📜 Intellectual Property

NerveMind CGOS is a patented system by Keymatrix Solutions.

  • Indian Patent: Published
  • International Patent: Filed under WIPO (PCT)

For more details, contact: info@keymatrixsolutions.com

Install in seconds:

pip install nervemind-cgos

🚀 What is CGOS?

CGOS (Cognitive Governance Operating System) is a control layer that ensures all AI and system actions are evaluated, approved, and enforced based on governance rules before execution.

This SDK allows you to integrate CGOS into your system in minutes.


⚡ Quick Start

from cgos_sdk import CGOSClient

client = CGOSClient(
    base_url="https://your-cgos-api.com",
    api_key="your-api-key"
)

response = client.submit_decision(
    source_system="loan_system",
    sector="finance",
    decision_type="loan_approval",
    decision_id="loan_123",
    context={"amount": 50000},
    policy_set="default",
    callback_url="https://your-system.com/callback"
)

print(response)

🧠 Core Capabilities

  • Submit decisions for governance evaluation
  • Validate execution proofs
  • Invoke controlled execution flows
  • Built-in retry, tracing, and observability hooks

🔁 Typical Flow

Your System → CGOS → Governance Decision → Execution Control
  1. Submit action to CGOS
  2. CGOS evaluates against policies
  3. Receive approval / rejection / escalation
  4. Execute action through controlled pathway

📦 Key Methods

Submit Decision

client.submit_decision(...)

Send an action to CGOS for governance evaluation.


Verify Proof

client.verify_proof(proof_id="...")

Validate that an action is approved before execution.


Invoke Execution

client.invoke_execution(...)

Execute actions through CGOS-controlled pathways.


🔐 Authentication

You can use:

  • API Key (external systems)
  • Internal Service Token (secure backend)
  • Bearer Token (admin / internal flows)

🏗️ Architecture

CGOS enforces governance by sitting between decision-making and execution:

AI / User Request
        ↓
     CGOS
        ↓
Execution Control
        ↓
Core System

⚠️ Important

  • CGOS does NOT execute actions directly
  • It enforces whether actions are allowed or not
  • Execution should always be gated by CGOS

📄 License

MIT License © Keymatrix Solutions


🌐 Learn More


🤝 Contributing

Contributions are welcome. Please open an issue or submit a pull request.


🚀 About

Built by Keymatrix Solutions to bring governance, control, and safety to AI-driven systems.