# Agent as Code (AaC)
====================================
Welcome to the Agent as Code (AaC) framework documentation. This guide will help you understand and use the framework to create, build, and deploy AI agents using declarative configuration.
## What is Agent as Code?
Agent as Code (AaC) is a declarative configuration system for AI agents, inspired by Docker and Infrastructure as Code (IaC). It enables developers to define AI agents using simple, version-controlled configuration files.
**Think of it as "Docker for AI agents"** - just like Dockerfile makes it easy to define and build containers, Agentfile makes it easy to define and build AI agents.
## Core Philosophy
- **Declarative**: Define what the agent should do, not how to do it
- **Version Controlled**: Track agent configurations in Git
- **Reusable**: Share and reuse agent configurations
- **Simple**: Easy to understand and modify
- **Portable**: Work across different environments and clouds
## Quick Start
```bash
# Install the framework
pip install agent-as-code
# Create your first agent
agent init my-first-agent
# Build the agent
agent build -t my-first-agent:latest .
# Run the agent
agent run my-first-agent:latest
```
## Documentation Sections
### Core Pages
1. **[Home](https://agent-as-code.myagentregistry.com/)** — Overview and latest updates
2. **[Getting Started](https://agent-as-code.myagentregistry.com/getting-started)** — Prerequisites, installation, quick start, first agent, and deployment options
3. **[Documentation](https://agent-as-code.myagentregistry.com/documentation)** — Full technical documentation hub
### Component Guides
4. **[Agentfile](https://agent-as-code.myagentregistry.com/documentation#agentfile)** — Write and structure your Agentfile
5. **[Parser](https://agent-as-code.myagentregistry.com/documentation#parser)** — Validation and parsing rules
6. **[Builder](https://agent-as-code.myagentregistry.com/documentation#builder)** — Building and packaging agents
7. **[Runtime](https://agent-as-code.myagentregistry.com/documentation#runtime)** — Execution environments
### CLI and Registry
8. **[CLI Reference](https://agent-as-code.myagentregistry.com/cli)** — Commands, options, and workflows
9. **[Registry Guide](https://agent-as-code.myagentregistry.com/registry)** — Remote registry, PAT, versioning, and security
### Examples
10. **[Examples](https://agent-as-code.myagentregistry.com/examples)** — Real-world examples and use cases
## Framework Goals
### Primary Objectives
1. **Simplify AI Agent Development**
- Reduce complexity of agent creation
- Provide standardized patterns
- Enable rapid prototyping
2. **Enable Declarative Configuration**
- Version-controlled agent definitions
- Infrastructure as Code principles
- Reproducible deployments
3. **Facilitate Agent Sharing**
- Centralized registry for agents
- Easy distribution and discovery
- Community-driven development
4. **Support Multiple Runtimes**
- Docker containerization
- Kubernetes deployment
- Cloud-native architectures
### Key Benefits
- **Developer Experience**: Familiar Docker-like commands
- **Portability**: Run agents anywhere
- **Scalability**: Cloud-native micro-service architecture
- **Collaboration**: Share agents through registry
- **Automation**: CI/CD pipeline integration
## Architecture Overview
```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Agentfile │───▶│ AaC Parser │───▶│ Agent Builder │
│ (Config) │ │ (Validation) │ │ (Packaging) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Registry │◀───│ Agent CLI │◀───│ Agent Runtime │
│ (Storage) │ │ (Commands) │ │ (Execution) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
```
## Getting Help
- **Documentation**: https://agent-as-code.myagentregistry.com/documentation
- **Getting Started**: https://agent-as-code.myagentregistry.com/getting-started
- **Examples**: https://agent-as-code.myagentregistry.com/examples
- **CLI Help**: Run `agent --help` for command reference
## Next Steps
1. Read **[Getting Started](https://agent-as-code.myagentregistry.com/getting-started)**
2. Explore **[Examples](https://agent-as-code.myagentregistry.com/examples)**
3. Review **[CLI Reference](https://agent-as-code.myagentregistry.com/cli#overview)**
4. Create your first agent with `agent init`
---
**Ready to build your first AI agent?** Start with **[Getting Started](https://agent-as-code.myagentregistry.com/getting-started#quick-start)**!
Raw data
{
"_id": null,
"home_page": "https://agent-as-code.myagentregistry.com",
"name": "agent-as-code",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "ai, agent, configuration, declarative, docker-like",
"author": "Partha Sarathi Kundu",
"author_email": "inboxpartha@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/91/33/d06d1ed9736e08458b81560714a8f2c3a2c9fe403db5a6ad8683570c9b29/agent_as_code-0.1.0b3.tar.gz",
"platform": null,
"description": "# Agent as Code (AaC)\n====================================\n\nWelcome to the Agent as Code (AaC) framework documentation. This guide will help you understand and use the framework to create, build, and deploy AI agents using declarative configuration.\n\n## What is Agent as Code?\n\nAgent as Code (AaC) is a declarative configuration system for AI agents, inspired by Docker and Infrastructure as Code (IaC). It enables developers to define AI agents using simple, version-controlled configuration files.\n\n**Think of it as \"Docker for AI agents\"** - just like Dockerfile makes it easy to define and build containers, Agentfile makes it easy to define and build AI agents.\n\n## Core Philosophy\n\n- **Declarative**: Define what the agent should do, not how to do it\n- **Version Controlled**: Track agent configurations in Git\n- **Reusable**: Share and reuse agent configurations\n- **Simple**: Easy to understand and modify\n- **Portable**: Work across different environments and clouds\n\n## Quick Start\n\n```bash\n# Install the framework\npip install agent-as-code\n\n# Create your first agent\nagent init my-first-agent\n\n# Build the agent\nagent build -t my-first-agent:latest .\n\n# Run the agent\nagent run my-first-agent:latest\n```\n\n## Documentation Sections\n\n### Core Pages\n\n1. **[Home](https://agent-as-code.myagentregistry.com/)** \u2014 Overview and latest updates\n2. **[Getting Started](https://agent-as-code.myagentregistry.com/getting-started)** \u2014 Prerequisites, installation, quick start, first agent, and deployment options\n3. **[Documentation](https://agent-as-code.myagentregistry.com/documentation)** \u2014 Full technical documentation hub\n\n### Component Guides\n\n4. **[Agentfile](https://agent-as-code.myagentregistry.com/documentation#agentfile)** \u2014 Write and structure your Agentfile\n5. **[Parser](https://agent-as-code.myagentregistry.com/documentation#parser)** \u2014 Validation and parsing rules\n6. **[Builder](https://agent-as-code.myagentregistry.com/documentation#builder)** \u2014 Building and packaging agents\n7. **[Runtime](https://agent-as-code.myagentregistry.com/documentation#runtime)** \u2014 Execution environments\n\n### CLI and Registry\n\n8. **[CLI Reference](https://agent-as-code.myagentregistry.com/cli)** \u2014 Commands, options, and workflows\n9. **[Registry Guide](https://agent-as-code.myagentregistry.com/registry)** \u2014 Remote registry, PAT, versioning, and security\n\n### Examples\n\n10. **[Examples](https://agent-as-code.myagentregistry.com/examples)** \u2014 Real-world examples and use cases\n\n## Framework Goals\n\n### Primary Objectives\n\n1. **Simplify AI Agent Development**\n - Reduce complexity of agent creation\n - Provide standardized patterns\n - Enable rapid prototyping\n\n2. **Enable Declarative Configuration**\n - Version-controlled agent definitions\n - Infrastructure as Code principles\n - Reproducible deployments\n\n3. **Facilitate Agent Sharing**\n - Centralized registry for agents\n - Easy distribution and discovery\n - Community-driven development\n\n4. **Support Multiple Runtimes**\n - Docker containerization\n - Kubernetes deployment\n - Cloud-native architectures\n\n### Key Benefits\n\n- **Developer Experience**: Familiar Docker-like commands\n- **Portability**: Run agents anywhere\n- **Scalability**: Cloud-native micro-service architecture\n- **Collaboration**: Share agents through registry\n- **Automation**: CI/CD pipeline integration\n\n## Architecture Overview\n\n```\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Agentfile \u2502\u2500\u2500\u2500\u25b6\u2502 AaC Parser \u2502\u2500\u2500\u2500\u25b6\u2502 Agent Builder \u2502\n\u2502 (Config) \u2502 \u2502 (Validation) \u2502 \u2502 (Packaging) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Registry \u2502\u25c0\u2500\u2500\u2500\u2502 Agent CLI \u2502\u25c0\u2500\u2500\u2500\u2502 Agent Runtime \u2502\n\u2502 (Storage) \u2502 \u2502 (Commands) \u2502 \u2502 (Execution) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## Getting Help\n\n- **Documentation**: https://agent-as-code.myagentregistry.com/documentation\n- **Getting Started**: https://agent-as-code.myagentregistry.com/getting-started\n- **Examples**: https://agent-as-code.myagentregistry.com/examples\n- **CLI Help**: Run `agent --help` for command reference\n\n## Next Steps\n\n1. Read **[Getting Started](https://agent-as-code.myagentregistry.com/getting-started)**\n2. Explore **[Examples](https://agent-as-code.myagentregistry.com/examples)**\n3. Review **[CLI Reference](https://agent-as-code.myagentregistry.com/cli#overview)**\n4. Create your first agent with `agent init`\n\n---\n\n**Ready to build your first AI agent?** Start with **[Getting Started](https://agent-as-code.myagentregistry.com/getting-started#quick-start)**!\n",
"bugtrack_url": null,
"license": null,
"summary": "Declarative configuration system for AI agents",
"version": "0.1.0b3",
"project_urls": {
"CLI": "https://agent-as-code.myagentregistry.com/cli",
"CLI - Configuration": "https://agent-as-code.myagentregistry.com/cli#configuration",
"CLI - Core Commands": "https://agent-as-code.myagentregistry.com/cli#core-commands",
"CLI - Global Options": "https://agent-as-code.myagentregistry.com/cli#global-options",
"CLI - Installation": "https://agent-as-code.myagentregistry.com/cli#installation",
"CLI - Overview": "https://agent-as-code.myagentregistry.com/cli#overview",
"CLI - Registry Commands": "https://agent-as-code.myagentregistry.com/cli#registry-commands",
"CLI - Workflow Examples": "https://agent-as-code.myagentregistry.com/cli#workflow-examples",
"CLI - agent build": "https://agent-as-code.myagentregistry.com/cli#agent-build",
"CLI - agent configure": "https://agent-as-code.myagentregistry.com/cli#agent-configure",
"CLI - agent images": "https://agent-as-code.myagentregistry.com/cli#agent-images",
"CLI - agent init": "https://agent-as-code.myagentregistry.com/cli#agent-init",
"CLI - agent inspect": "https://agent-as-code.myagentregistry.com/cli#agent-inspect",
"CLI - agent pull": "https://agent-as-code.myagentregistry.com/cli#agent-pull",
"CLI - agent push": "https://agent-as-code.myagentregistry.com/cli#agent-push",
"CLI - agent rmi": "https://agent-as-code.myagentregistry.com/cli#agent-rmi",
"CLI - agent run": "https://agent-as-code.myagentregistry.com/cli#agent-run",
"CLI - agent test": "https://agent-as-code.myagentregistry.com/cli#agent-test",
"Developed_By": "https://github.com/pxkundu",
"Docs - Agent Runtime Strategies": "https://agent-as-code.myagentregistry.com/documentation#agent-runtime-strategies",
"Docs - Agentfile": "https://agent-as-code.myagentregistry.com/documentation#agentfile",
"Docs - Builder": "https://agent-as-code.myagentregistry.com/documentation#builder",
"Docs - Bulletproof Runtimes": "https://agent-as-code.myagentregistry.com/documentation#bulletproof-runtimes",
"Docs - Cloud Agnostic Runtime": "https://agent-as-code.myagentregistry.com/documentation#cloud-agnostic-runtime",
"Docs - Deployment Strategies": "https://agent-as-code.myagentregistry.com/documentation#deployment-strategies",
"Docs - PAT Documentation": "https://agent-as-code.myagentregistry.com/documentation#pat-documentation",
"Docs - PAT Quick Reference": "https://agent-as-code.myagentregistry.com/documentation#pat-quick-reference",
"Docs - PAT System": "https://agent-as-code.myagentregistry.com/documentation#pat-system",
"Docs - PAT Technical": "https://agent-as-code.myagentregistry.com/documentation#pat-technical-implementation",
"Docs - Parser": "https://agent-as-code.myagentregistry.com/documentation#parser",
"Docs - Runtime": "https://agent-as-code.myagentregistry.com/documentation#runtime",
"Documentation": "https://agent-as-code.myagentregistry.com/documentation",
"Examples": "https://agent-as-code.myagentregistry.com/examples",
"Examples - Communication": "https://agent-as-code.myagentregistry.com/examples#communication",
"Examples - Content Creation": "https://agent-as-code.myagentregistry.com/examples#content-creation",
"Examples - Data Analysis": "https://agent-as-code.myagentregistry.com/examples#data-analysis",
"Examples - Data Processing": "https://agent-as-code.myagentregistry.com/examples#data-processing",
"Examples - Development": "https://agent-as-code.myagentregistry.com/examples#development",
"Examples - Monitoring": "https://agent-as-code.myagentregistry.com/examples#monitoring",
"Examples - Sentiment Analysis": "https://agent-as-code.myagentregistry.com/examples#sentiment-analysis",
"Examples - Text Generation": "https://agent-as-code.myagentregistry.com/examples#text-generation",
"Examples - Use Cases": "https://agent-as-code.myagentregistry.com/examples#use-cases",
"Examples - Weather Monitoring": "https://agent-as-code.myagentregistry.com/examples#weather-monitoring",
"Getting Started": "https://agent-as-code.myagentregistry.com/getting-started",
"Getting Started - Deployment": "https://agent-as-code.myagentregistry.com/getting-started#deployment-options",
"Getting Started - First Agent": "https://agent-as-code.myagentregistry.com/getting-started#first-agent",
"Getting Started - Installation": "https://agent-as-code.myagentregistry.com/getting-started#installation",
"Getting Started - Prerequisites": "https://agent-as-code.myagentregistry.com/getting-started#prerequisites",
"Getting Started - Quick Start": "https://agent-as-code.myagentregistry.com/getting-started#quick-start",
"Getting Started - Registry Ops": "https://agent-as-code.myagentregistry.com/getting-started#registry-operations",
"Homepage": "https://agent-as-code.myagentregistry.com",
"PyPI": "https://pypi.org/project/agent-as-code/",
"Registry": "https://agent-as-code.myagentregistry.com/registry",
"Registry - Access Control": "https://agent-as-code.myagentregistry.com/registry#access-control",
"Registry - Architecture": "https://agent-as-code.myagentregistry.com/registry#architecture",
"Registry - Configuration": "https://agent-as-code.myagentregistry.com/registry#configuration",
"Registry - Discovery": "https://agent-as-code.myagentregistry.com/registry#agent-discovery",
"Registry - Metadata": "https://agent-as-code.myagentregistry.com/registry#agent-metadata",
"Registry - Monitoring": "https://agent-as-code.myagentregistry.com/registry#monitoring",
"Registry - Operations": "https://agent-as-code.myagentregistry.com/registry#registry-operations",
"Registry - Overview": "https://agent-as-code.myagentregistry.com/registry#overview",
"Registry - Security": "https://agent-as-code.myagentregistry.com/registry#security",
"Registry - Versioning": "https://agent-as-code.myagentregistry.com/registry#version-management",
"Registry_Home": "https://www.myagentregistry.com",
"Website": "https://agent-as-code.myagentregistry.com/"
},
"split_keywords": [
"ai",
" agent",
" configuration",
" declarative",
" docker-like"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cef15402933d7e025a0cb321e37c2959f80c371f5c5da67f0543b52fa045456e",
"md5": "0e3014f53823c3140230504e7a151d99",
"sha256": "4a51f31cc7bebe0c16cc9c6a6e9830b97e23d769b95d1b9bf7882ac5846f4892"
},
"downloads": -1,
"filename": "agent_as_code-0.1.0b3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0e3014f53823c3140230504e7a151d99",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 38980,
"upload_time": "2025-08-07T22:14:22",
"upload_time_iso_8601": "2025-08-07T22:14:22.738550Z",
"url": "https://files.pythonhosted.org/packages/ce/f1/5402933d7e025a0cb321e37c2959f80c371f5c5da67f0543b52fa045456e/agent_as_code-0.1.0b3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9133d06d1ed9736e08458b81560714a8f2c3a2c9fe403db5a6ad8683570c9b29",
"md5": "6e36bbc83918dc1f09811ab2fc4185a0",
"sha256": "13db588f1566a19491c8f1e175523954fa8cee61bbb28b28cbf189e4b5e7fa57"
},
"downloads": -1,
"filename": "agent_as_code-0.1.0b3.tar.gz",
"has_sig": false,
"md5_digest": "6e36bbc83918dc1f09811ab2fc4185a0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 118519,
"upload_time": "2025-08-07T22:14:23",
"upload_time_iso_8601": "2025-08-07T22:14:23.958704Z",
"url": "https://files.pythonhosted.org/packages/91/33/d06d1ed9736e08458b81560714a8f2c3a2c9fe403db5a6ad8683570c9b29/agent_as_code-0.1.0b3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 22:14:23",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "agent-as-code"
}
JSON