Metadata-Version: 2.4
Name: aicippy
Version: 3.11.25
Summary: Enterprise-grade multi-agent CLI for Vibe Coding
Author-email: Aravind Jayamohan <aravind@aivibe.in>
Maintainer-email: AiVibe Software Services Pvt Ltd <support@aivibe.in>
License-Expression: LicenseRef-Proprietary
Keywords: ai,cli,bedrock,multi-agent,aws,enterprise,browser-agent,aivibe
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Shells
Classifier: Typing :: Typed
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9
Requires-Dist: rich>=13.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: boto3>=1.34
Requires-Dist: botocore>=1.34
Requires-Dist: httpx>=0.25
Requires-Dist: certifi>=2024.2.2
Requires-Dist: anyio>=4.0
Requires-Dist: keyring>=25.0
Requires-Dist: python-jose[cryptography]>=3.3
Requires-Dist: aiofiles>=23.0
Requires-Dist: tenacity>=8.0
Requires-Dist: structlog>=23.0
Requires-Dist: orjson>=3.9
Requires-Dist: prompt-toolkit>=3.0
Requires-Dist: feedparser>=6.0
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: lxml>=5.0
Requires-Dist: markdown>=3.5
Requires-Dist: websockets>=14.0
Requires-Dist: google-cloud-aiplatform>=1.38
Requires-Dist: colorama>=0.4
Requires-Dist: tqdm>=4.60
Requires-Dist: textual>=1.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: pytest-mock>=3.12; extra == "dev"
Requires-Dist: ruff==0.16.6; extra == "dev"
Provides-Extra: db
Requires-Dist: asyncpg~=0.31.0; extra == "db"
Provides-Extra: cdk
Requires-Dist: aws-cdk-lib~=2.142.1; extra == "cdk"
Requires-Dist: aws-cdk~=2.142.1; extra == "cdk"
Requires-Dist: constructs~=10.3.0; extra == "cdk"
Dynamic: license-file

# AiCippy

An autonomous development agent that runs on **GPT-6 Astra via Amazon Bedrock**.
It inspects, reasons, plans, edits, runs, debugs, tests, deploys, remembers, and
reports real evidence from your development environment — from a terminal, a
TUI, or a browser side panel, all driving the same runtime.

```bash
pip install aicippy
aicippy task run "add retry handling to the payment webhook and prove it works"
```

---

## One provider, one config, one runtime

Everything that reaches the model goes through a single path:

| Concern | The one place it lives |
| --- | --- |
| Model, endpoint, region, capabilities, tool contract | `aicippy.astra.runtime` |
| Inference | `aicippy.astra.provider.AstraProvider` (SigV4 → Bedrock Mantle Responses) |
| Live events | `aicippy.astra.events.AstraEvent` |
| Task execution | `aicippy.orchestration.loop.OrchestrationLoop` |
| Tools | `aicippy.tools.registry.ToolRegistry` |
| Memory | `aicippy.memory.store.MemoryStore` |

The CLI, the Textual TUI, the WebSocket Lambda and the browser extension all
resolve from these. The Lambda and the extension read the deployment-generated
`astra.runtime.json` that `export_runtime_config()` writes, so a value can only
change in one place.

## Documentation

| Guide | Covers |
| --- | --- |
| [Installation & configuration](docs/installation.md) | Install, AWS setup, model access, configuration reference |
| [AWS permissions](docs/aws-permissions.md) | The exact IAM policy, profiles, and inference profiles |
| [CLI usage](docs/cli-usage.md) | Every command, autonomous task modes, memory controls |
| [Browser integration](docs/browser-integration.md) | Side panel, shared tasks, browser debugging |
| [MCP integration](docs/mcp-integration.md) | Discovery, selection, and calling MCP tools |
| [Cloud deployment](docs/deployment.md) | Deploying the backend and publishing the CLI |
| [Architecture](docs/architecture.md) | How the runtime, loop, agents, memory and events fit together |
| [Troubleshooting](docs/troubleshooting.md) | Diagnostics, error categories, and what each one means |
| [Migration guide](docs/migration.md) | Moving off the NVIDIA/Nemotron and Bedrock Agent routes |

## Quick start

```bash
# 1. AWS credentials that can call bedrock-mantle:CreateInference
export AWS_PROFILE=your-profile

# 2. Check the live route end to end
aicippy doctor

# 3. Run an autonomous task
aicippy task run "fix the failing auth test"

# 4. Or dispatch the specialist fleet for larger work
aicippy task run --multi-agent "migrate the billing service to the new API"

# 5. Resume anything that was interrupted
aicippy task resume
```

The prompt-toolkit terminal is the default interface; `AICIPPY_TUI=1 aicippy`
opens the Textual one. Both drive the same runtime.

## What a task actually does

```
understand → inspect repo state → plan → select tools → execute → inspect results
     → repair failures → verify → report evidence → preserve state for resume
```

Every step emits a live event. Nothing is reported as done that was not observed:
if a test failed, you get the output; if a step was skipped, you are told.

## License

Proprietary — AiVibe Software Services Pvt Ltd. See [LICENSE](LICENSE).
