Metadata-Version: 2.4
Name: zin-adk
Version: 0.1.4
Summary: ZAK — Zeron Agentic Kit, open-source ADK for building autonomous cybersecurity agents. Build, deploy, and govern autonomous cybersecurity agents.
Author-email: "zeron.one" <info@zeron.one>
Maintainer-email: "zeron.one" <info@zeron.one>
License: Apache-2.0
Project-URL: Homepage, https://zeron.one
Project-URL: Repository, https://github.com/securezeron/zeron-agent-development-kit
Project-URL: Bug Tracker, https://github.com/securezeron/zeron-agent-development-kit/issues
Project-URL: Changelog, https://github.com/securezeron/zeron-agent-development-kit/blob/main/CHANGELOG.md
Project-URL: Documentation, https://securezeron.github.io/zeron-agent-development-kit
Keywords: cybersecurity,security-agents,ai-agents,autonomous-agents,risk-quantification,devsecops,soc-automation,vulnerability-management,compliance-automation,security-intelligence
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: structlog>=23.0
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Requires-Dist: python-ulid>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Provides-Extra: llm
Requires-Dist: openai>=1.30; extra == "llm"
Requires-Dist: anthropic>=0.28; extra == "llm"
Requires-Dist: google-generativeai>=0.7; extra == "llm"
Provides-Extra: graph
Requires-Dist: neo4j>=5.0; extra == "graph"
Dynamic: license-file

<p align="center">
  <img src="docs/assets/images/zak-adk-primary.png" alt="ZAK — Zeron Agent Development Kit" height="60" />
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License" /></a>
  <a href="https://pypi.org/project/zin-adk/"><img src="https://img.shields.io/pypi/v/zin-adk.svg" alt="PyPI" /></a>
  <a href="https://pypi.org/project/zin-adk/"><img src="https://img.shields.io/pypi/pyversions/zin-adk.svg" alt="Python" /></a>
</p>

**ZAK** is an open-source **Agent Development Kit** for building, deploying, and governing autonomous cybersecurity agents.

---

## Quick Start

```bash
pip install zin-adk

# Scaffold a new agent
zak init --name "My Risk Agent" --domain risk_quant --out ./agents

# Implement agents/my_risk_agent.py → execute()

# Validate
zak validate agents/my-risk-agent.yaml

# Run
zak run agents/my-risk-agent.yaml --tenant acme
```

---

## Built-in Agents

| Domain | Description |
|--------|-------------|
| `risk_quant` | FAIR-inspired risk scoring for all assets |
| `vuln_triage` | Prioritize CVEs by severity, criticality, and exploitability |
| `appsec` | SAST, SCA, secrets detection, and dependency scanning |
| `generic` | DSL-only custom agent executor |

---

## Key Features

- **US-ADSL** — Declarative YAML schema for agent definitions
- **Policy Engine** — 6 runtime guardrails enforced on every tool call
- **Tool Substrate** — `@zak_tool` decorator for safe, audited tool execution
- **SIF Graph** — Security Intelligence Fabric for shared knowledge persistence
- **Multi-tenant** — Namespace isolation per tenant
- **LLM Modes** — ReAct reasoning with OpenAI, Anthropic, Google, or local Ollama

---

## Installation Options

```bash
pip install zin-adk                  # Core + CLI
pip install "zin-adk[llm]"           # + LLM providers (OpenAI, Anthropic, Google)
pip install "zin-adk[graph]"         # + Memgraph/Neo4j graph backend
pip install "zin-adk[dev]"           # + Dev tools (pytest, ruff, mypy)
```

---

## CLI Commands

| Command | Description |
|---------|-------------|
| `zak init` | Scaffold a new agent (YAML + Python) |
| `zak validate` | Validate a YAML agent definition |
| `zak run` | Execute an agent in a tenant context |
| `zak agents` | List registered agents |
| `zak info` | Show platform info |

---

## Architecture

```
┌─────────────────────────────────────────────────┐
│              Your Agent (BaseAgent)              │
│          define: execute() + @zak_tool           │
└─────────────────────┬───────────────────────────┘
                      │ calls ToolExecutor.call()
┌─────────────────────▼───────────────────────────┐
│               ZAK Core Layer                    │
│  PolicyEngine  │  AuditLogger  │  AgentExecutor │
└─────────────────────┬───────────────────────────┘
                      │ reads/writes
┌─────────────────────▼───────────────────────────┐
│      Security Intelligence Fabric (SIF)         │
│   Asset  │  Vulnerability  │  Risk  │  Vendor   │
└─────────────────────────────────────────────────┘
```

---

## Enterprise Edition

Need more? The **ZAK Enterprise Edition** adds 19 additional agents:

AI Security, API Security, Attack Surface, Cloud Posture, Compliance,
Container Security, Cyber Insurance, Data Privacy, IaC Security, IAM Drift,
Identity Risk, Incident Response, Malware Analysis, Network Security,
Pentest Automation, Red Team, Supply Chain, Threat Detection, Threat Intel

Plus: REST API server, platform dashboard, user management, and integrations.

**Learn more at [zeron.one](https://zeron.one)**

---

## Documentation

Full docs: [securezeron.github.io/zeron-agent-development-kit](https://securezeron.github.io/zeron-agent-development-kit)

---

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

---

## License

Apache 2.0 — see [LICENSE](LICENSE).
