Metadata-Version: 2.4
Name: armoriq-sdk
Version: 0.3.4
Summary: ArmorIQ SDK - Build secure AI agents with cryptographic intent verification.
Home-page: https://armoriq.ai
Author: ArmorIQ Team
Author-email: ArmorIQ Team <license@armoriq.io>
License: MIT
Project-URL: Homepage, https://armoriq.ai
Project-URL: Documentation, https://docs.armoriq.ai
Project-URL: Source Code, https://github.com/armoriq/armoriq-sdk-python
Keywords: armoriq,sdk,ai,agents,security,verification
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: PyYAML>=6.0
Provides-Extra: crewai
Requires-Dist: crewai>=0.28.0; extra == "crewai"
Provides-Extra: langchain
Requires-Dist: langchain>=0.1.0; extra == "langchain"
Provides-Extra: google-adk
Requires-Dist: google-adk>=1.0.0; extra == "google-adk"
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == "openai"
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.20.0; extra == "anthropic"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Provides-Extra: all
Requires-Dist: crewai>=0.28.0; extra == "all"
Requires-Dist: langchain>=0.1.0; extra == "all"
Requires-Dist: google-adk>=1.0.0; extra == "all"
Requires-Dist: openai>=1.0.0; extra == "all"
Requires-Dist: anthropic>=0.20.0; extra == "all"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# ArmorIQ SDK

**Build secure AI agents with cryptographic intent verification.**

The ArmorIQ SDK enables developers to build AI agents with built-in security and auditability. Just one API key - no cloud complexity.

---

## Why ArmorIQ?

- **Simple** - Just one API key, no cloud credentials
- **Secure** - Cryptographic verification for every action
- **Auditable** - Complete execution trail
- **Fast** - Get started in 5 minutes

---

## Installation

```bash
pip install armoriq-sdk
```

CLI commands are also available after install:

```bash
armoriq --help
```

---

## Quick Start

### 1. Get Your API Key

Visit [platform.armoriq.ai](https://platform.armoriq.ai) to generate your API key.

### 2. Initialize the Client

```python
from armoriq_sdk import ArmorIQClient

client = ArmorIQClient(
    api_key="ak_your_key_here",
    user_id="your-user-id",
    agent_id="your-agent-id"
)
```

Or load SDK settings from `armoriq.yaml` generated by the CLI:

```python
from armoriq_sdk import ArmorIQClient

client = ArmorIQClient.from_config("armoriq.yaml")
```

### 3. Capture Your Plan

```python
plan = {
    "goal": "Get weather forecast",
    "steps": [
        {
            "action": "get_weather",
            "tool": "weather_api",
            "inputs": {"city": "Boston"}
        }
    ]
}

plan_capture = client.capture_plan(
    llm="gpt-4",
    prompt="What's the weather in Boston?",
    plan=plan
)
```

### 4. Get Intent Token

```python
token = client.get_intent_token(plan_capture)
```

### 5. Invoke Actions

```python
result = client.invoke(
    mcp_name="weather-mcp",
    action="get_weather",
    intent_token=token,
    inputs={"city": "Boston"}
)

print(result)
```

---

## Documentation

For complete documentation, visit [docs.armoriq.ai](https://docs.armoriq.ai)

---

## Links

- [armoriq.ai](https://armoriq.ai)
- [docs.armoriq.ai](https://docs.armoriq.ai)
- [platform.armoriq.ai](https://platform.armoriq.ai)

---

## License

MIT License - see [LICENSE](LICENSE) file for details.
