Skip to main content

Enterprise-grade multi-agent CLI system powered by AWS Bedrock

Project description

AiCippy

Enterprise-grade multi-agent CLI system powered by AWS Bedrock.

Copyright (c) 2024-2026 AiVibe Software Services Pvt Ltd. All rights reserved.

ISO 27001:2022 Certified | NVIDIA Inception Partner | AWS Activate | Microsoft for Startups

Overview

AiCippy is a production-grade, multi-agent command-line system that orchestrates up to 10 parallel AI agents to complete complex tasks. Built on AWS Bedrock Agents, it provides:

  • Multi-agent orchestration with parallel execution
  • Real-time WebSocket communication
  • MCP-style tool connectors for AWS, GitHub, Firebase, and more
  • Knowledge Base integration with automated feed ingestion
  • Rich terminal UI with live progress and agent status

Installation

pip install aicippy

Quick Start

# Authenticate
aicippy login

# Initialize in a project
aicippy init

# Interactive mode
aicippy

# Single query
aicippy chat "Explain this codebase"

# Multi-agent task
aicippy run "Deploy infrastructure to AWS" --agents 5

Commands

Command Description
aicippy Start interactive session
aicippy login Authenticate with Cognito
aicippy logout Clear credentials
aicippy init Initialize project context
aicippy chat <msg> Single query mode
aicippy run <task> Execute with agents
aicippy config Show/edit configuration
aicippy status Agent status
aicippy usage Token usage
aicippy upgrade Self-update

Interactive Commands

Command Description
/help Show all commands
/model <name> Switch model (opus/sonnet/llama)
/mode <name> Change mode (agent/edit/research/code)
/agents spawn <n> Spawn parallel agents (1-10)
/agents list List active agents
/agents stop Stop agents
/kb sync Sync to Knowledge Base
/tools list List available tools
/usage Token usage
/quit Exit

Architecture

                     +----------------+
                     |   AiCippy CLI  |
                     +--------+-------+
                              |
                     +--------v--------+
                     | Agent Orchestrator |
                     +--------+---------+
                              |
         +--------------------+--------------------+
         |         |          |          |         |
    +----v----+ +--v---+ +----v---+ +----v----+ +--v----+
    |Agent-1  | |Agent-2| |Agent-3 | |Agent-4  | |Agent-N|
    |INFRA    | |BEDROCK| |API-GW  | |CLI-CORE | |...    |
    +---------+ +-------+ +--------+ +---------+ +-------+
         |         |          |          |         |
    +----v---------v----------v----------v---------v----+
    |              AWS Bedrock Runtime                  |
    +--------------------------------------------------+

Supported Models

  • Claude Opus 4.5 (default) - Most capable model
  • Claude Sonnet 4.5 - Balanced performance
  • Llama 4 Maverick - Open source alternative

MCP Tool Connectors

  • AWS CLI (aws)
  • Google Cloud CLI (gcloud)
  • GitHub CLI (gh)
  • Firebase CLI (firebase)
  • Figma API
  • Google Drive API
  • Gmail API
  • Razorpay API
  • PayPal API
  • Stripe CLI
  • Shell commands (sandboxed)

Configuration

Environment variables (or .env file):

AICIPPY_AWS_REGION=us-east-1
AICIPPY_DEFAULT_MODEL=opus
AICIPPY_MAX_PARALLEL_AGENTS=10
AICIPPY_LOG_LEVEL=INFO

Configuration file: ~/.aicippy/config.toml

Security

  • OAuth 2.0 authentication via AWS Cognito
  • Tokens stored in OS keychain (macOS Keychain, Windows Credential Manager)
  • All communications over TLS 1.3
  • Secrets never logged or printed
  • IAM least privilege roles

Development

# Clone repository
git clone https://github.com/aivibe/aicippy.git
cd aicippy

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linter
ruff check src/

# Type checking
mypy src/aicippy/

Infrastructure Deployment

# Install CDK dependencies
cd infrastructure
pip install -r requirements.txt

# Deploy all stacks
cdk deploy --all

License

Proprietary - AiVibe Software Services Pvt Ltd

Support


Built with precision by AiVibe Software Services Pvt Ltd, Chennai, India.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aicippy-1.6.11.tar.gz (237.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aicippy-1.6.11-py3-none-any.whl (282.4 kB view details)

Uploaded Python 3

File details

Details for the file aicippy-1.6.11.tar.gz.

File metadata

  • Download URL: aicippy-1.6.11.tar.gz
  • Upload date:
  • Size: 237.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for aicippy-1.6.11.tar.gz
Algorithm Hash digest
SHA256 12fe04843992e5bc8aee65731196df71f68bc7f281b3674481a7ae48d349859d
MD5 0dec0a3f722d7c33830c1d093f38447c
BLAKE2b-256 f596b901e167c88fde8f6f4c88aa5b7119e649fe3ee52ff8115125b4c783409d

See more details on using hashes here.

File details

Details for the file aicippy-1.6.11-py3-none-any.whl.

File metadata

  • Download URL: aicippy-1.6.11-py3-none-any.whl
  • Upload date:
  • Size: 282.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for aicippy-1.6.11-py3-none-any.whl
Algorithm Hash digest
SHA256 56bc800be1549be5857ae08d6bb5f555a61e0e5b77cb0064568800d9eb17013b
MD5 4109db32f80c6edcd822836c8949a320
BLAKE2b-256 2e239c68a45591f7dd003a227e5b1b44204d8943b0887ae39362e793ee036b79

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page