aigency 0.0.1rc235167702__py3-none-any.whl → 0.1.0__py3-none-any.whl

aigency-0.1.0.dist-info/METADATA

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: aigency
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: google-adk>=1.11.0
+Requires-Dist: a2a-sdk>=0.3.0
+Requires-Dist: litellm<1.73.0,>=1.72.6
+Requires-Dist: pyyaml==6.0.2
+Requires-Dist: PyJWT==2.10.1
+
+# Aigency
+
+AI Agent Development Acceleration Kit — build, run, and orchestrate intelligent agents with a production‑ready Agent‑to‑Agent (A2A) runtime.
+
+Aigency provides primitives and utilities to define agents via simple YAML, instantiate them programmatically, and serve them over HTTP using the A2A server. It is designed to be modular, observable, and extensible.
+
+- Python: >= 3.12
+- PyPI package: `aigency`
+- Core deps: `a2a-sdk`, `pyyaml`, `litellm`, `PyJWT`, `google-adk`
+
+## Features
+- Config‑first agents: define agent behavior, skills, tools, and model in YAML
+- Agent generator: instantiate agents, build agent cards, and executors programmatically
+- A2A integration: serve agents over HTTP with Starlette‑based A2A server
+- MCP‑friendly: integrate external tools/services via Model Context Protocol (optional)
+- Observability: compatible with Phoenix and A2A Inspector for tracing and debugging
+- Docker‑friendly: used across example demos and containers
+
+## Installation
+```bash
+pip install aigency
+```
+Requires Python 3.12+.
+
+## Quickstart
+Minimal example for a single agent (no MCP) that responds in the user’s language.
+
+1) Create an agent config file (e.g., `agent_config.yaml`):
+```yaml
+metadata:
+  name: hello_agent
+  description: A simple example agent that greets and answers briefly.
+  version: 1.0.0
+
+service:
+  url: http://hello-agent:8080
+  capabilities:
+    streaming: true
+  interface:
+    default_input_modes: [text, text/plain]
+    default_output_modes: [text, text/plain]
+
+agent:
+  model:
+    name: gemini-2.0-flash
+
+  instruction: |
+      """
+      You are a friendly, concise assistant. Always reply in the same language as the user.
+      Keep responses short and helpful.
+      """
+
+  skills:
+    - id: greet
+      name: Greet
+      description: Greets users and offers help
+      examples:
+        - "Hello! How can I help you today?"
+```
+
+2) Run a tiny A2A app (e.g., `app.py`):
+```python
+import os
+import uvicorn
+from a2a.server.apps import A2AStarletteApplication
+from a2a.server.request_handlers import DefaultRequestHandler
+from a2a.server.tasks import InMemoryTaskStore
+from aigency.agents.generator import AgentA2AGenerator
+from aigency.utils.config_service import ConfigService
+
+CONFIG_PATH = os.path.join(os.path.dirname(__file__), "agent_config.yaml")
+
+config_service = ConfigService(config_file=CONFIG_PATH)
+agent_config = config_service.config
+
+agent = AgentA2AGenerator.create_agent(agent_config=agent_config)
+agent_card = AgentA2AGenerator.build_agent_card(agent_config=agent_config)
+executor = AgentA2AGenerator.build_executor(agent=agent, agent_card=agent_card)
+
+request_handler = DefaultRequestHandler(
+    agent_executor=executor,
+    task_store=InMemoryTaskStore(),
+)
+app = A2AStarletteApplication(
+    agent_card=agent_card,
+    http_handler=request_handler,
+).build()
+
+if __name__ == "__main__":
+    uvicorn.run(app, host="0.0.0.0", port=8080)
+```
+
+3) Start the server:
+```bash
+python app.py
+```
+Then open http://localhost:8080 to interact via the A2A HTTP interface or connect a compatible client.
+
+## Using Models & Providers
+Aigency integrates with LLM providers via its dependencies. For Google Gemini models:
+
+- Use API key (Google AI Studio):
+  - `GEMINI_API_KEY=your_gemini_api_key`
+  - `GOOGLE_GENAI_USE_VERTEXAI=FALSE`
+- Or use Vertex AI (requires additional env like project/region and credentials):
+  - `GOOGLE_GENAI_USE_VERTEXAI=TRUE`
+
+Set these environment variables before running your app if you use Gemini‑based models.
+
+## Configuration Reference (YAML)
+Common top‑level sections:
+
+- `metadata`: name, description, version
+- `service`: url, capabilities, interface defaults
+- `agent`:
+  - `model`: model name (e.g., `gemini-2.0-flash`)
+  - `instruction`: system prompt/persona
+  - `skills`: list of skills with `id`, `name`, `description`, and `examples`
+  - `tools`: optional integrations (e.g., MCP tools)
+- `observability`: optional Phoenix/A2A Inspector configuration
+
+Example of adding an MCP tool:
+```yaml
+tools:
+  - type: mcp
+    name: sample_mcp
+    description: Example MCP tool
+    mcp_config:
+      url: sample-mcp-service
+      port: 8080
+      path: /mcp/
+```
+
+## Examples & Demos
+Explore ready‑to‑run demos built with Aigency:
+
+- Reception Agent (single agent, no MCP):
+  https://aigency-project.github.io/get_started/demos/reception_aigent
+- Gossip Agent (single agent + MCP tools):
+  https://aigency-project.github.io/get_started/demos/gossip_agent
+- Detective Aigency (multi‑agent system):
+  https://aigency-project.github.io/get_started/demos/detective_aigency/
+
+Documentation site:
+- https://aigency-project.github.io/
+
+## Observability
+Aigency‑based apps can be observed with:
+- Phoenix dashboard (tracing/metrics)
+- A2A Inspector (agent/task introspection)
+
+Refer to the demo repositories for docker‑compose setups that launch these services.
+
+## Development
+- Python 3.12+
+- Install dev deps and run tests as usual; for versioning helpers, see `scripts/version_manager.py` in this repo.
+
+## License
+This project’s license is provided in the `LICENSE` file.

aigency-0.1.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+aigency/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aigency/agents/client.py,sha256=M2j6NpzjG4aeLmYY0NMsgjb6HQSLMVz9Cba7WJsEIQ8,2651
+aigency/agents/communicator.py,sha256=qr77SolCIiNrp7nmuFfPOscmdPnCWmgQwPQcBwJIlt4,5712
+aigency/agents/executor.py,sha256=0FdWQodUeTnYbMGe3CPOYxzhQ2uF0S7m2aJudTrdx20,7494
+aigency/agents/generator.py,sha256=D1O0Vn96kyruv6yvuZUWhE5yGxDpoUrYiDQpOEcS6N8,7363
+aigency/schemas/aigency_config.py,sha256=qbcHjmmMAG_-nWY689aS9wQ0gzbroQTpjPb9MlDBfmc,1817
+aigency/schemas/agent/agent.py,sha256=NamGZsk9ajOmIJiLyoSdFZsbJ8av6-0d2mTgHNG5z64,1910
+aigency/schemas/agent/model.py,sha256=FKLoXiPamrsFs1G8jFQkn0nvdp3rIlpMUg5BWmL1Klc,1381
+aigency/schemas/agent/remote_agent.py,sha256=wfqirTisFGQFwOAU_oKLyiYw_61ZZVp7lIfe1g_11ZA,1244
+aigency/schemas/agent/skills.py,sha256=LZntfTygAhuv09m5URbkygDhCD0-Sl2A9gEAJkgCncg,1287
+aigency/schemas/agent/tools.py,sha256=ANyzJstAFn3dg5JjpiwTGmkOHSFJ4-Ry7Fw2nmj1XNk,3526
+aigency/schemas/metadata/metadata.py,sha256=9mKSJgLfwjhRrKD3pvdNIuhk6b8c3pz1YaVIb5qOWMY,1108
+aigency/schemas/observability/observability.py,sha256=DHY4zmFg_qy7U97YILRJ02Y0tWNgcNB9w7akZaNbyfo,1302
+aigency/schemas/observability/phoenix.py,sha256=SpiStSw5xbXkEZH8HW56rCidMyjBi3OT3Y2i4D0tA_k,1018
+aigency/schemas/service/capabilities.py,sha256=sMQtqCaXYVnDebdKhZ48iKDL1h9CoXWoxh7TFm1LO6E,898
+aigency/schemas/service/interface.py,sha256=Jcp9Wy2sArhdeh_PiQNqcl0f2IMbipo3Muw5EWIoiiE,1140
+aigency/schemas/service/service.py,sha256=E_KZNiM-7DJS4Ezd8xPfFq_W8HkzIFZvzGe4sreDfjY,1415
+aigency/tools/generator.py,sha256=wMk5rt8wXSCci_K-vVyUMKvNuWlJcnpB7Y3SxRnfgG4,4355
+aigency/utils/config_service.py,sha256=ZE7xptJ20zk9sAJMxcDa2QYWMPhzfiW95gHquSX8E3s,5852
+aigency/utils/logger.py,sha256=kOIWbCTFiT4coz3cqcvD-YAu_EqIy4bqLBdaJ-sYOnk,6602
+aigency/utils/singleton.py,sha256=zwIj5c-A3F6BhK16AnwwxUX_qr_AbPAab-477nSGf7w,2267
+aigency/utils/utils.py,sha256=qjnzCV_5yOT0XG870_jU-xYnQeK1TUqVksU5Rnefxcs,4470
+aigency-0.1.0.dist-info/METADATA,sha256=XNj8kLxh_5HpkN5xAJrNEeVD_DZa6-ktlfW7CqnNXgo,5400
+aigency-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aigency-0.1.0.dist-info/top_level.txt,sha256=nr33Htucgjs3wJFNugPV8w7b9ZgSnytxCtRiinR3eb8,8
+aigency-0.1.0.dist-info/RECORD,,

aigency-0.0.1rc235167702.dist-info/METADATA

@@ -1,267 +0,0 @@
-Metadata-Version: 2.4
-Name: aigency
-Version: 0.0.1rc235167702
-Summary: Add your description here
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-Requires-Dist: google-adk>=1.11.0
-Requires-Dist: a2a-sdk==0.3.0
-Requires-Dist: litellm<1.73.0,>=1.72.6
-Requires-Dist: pyyaml==6.0.2
-Requires-Dist: PyJWT==2.10.1
-
-# aigency-lib
-
-A library for creating and managing AI agents.
-
-## Quick Start
-
-To test a simple agent:
-
-```bash
-cd examples/simple_agents/hello_world_agent
-docker compose up
-```
-
-## 🔧 Version Management
-
-This project includes an automated system for managing versions in both development and production.
-
-### Version Manager
-
-The `scripts/version_manager.py` script helps you manage your package versions locally.
-
-#### Available Commands
-
-##### 1. View current information
-```bash
-python scripts/version_manager.py show
-```
-**What it does:**
-- Shows the current version in `pyproject.toml`
-- Shows the current git branch
-- Shows the current commit
-- If you're not on `main`, suggests a development version
-
-**Example output:**
-```
-Current version: 0.0.1
-Branch: feature/new-agent
-Commit: a1b2c3d
-Suggested dev version: 0.0.1.dev20250409143022+feature/new-agent.a1b2c3d
-```
-
-##### 2. Create development version
-```bash
-python scripts/version_manager.py dev
-```
-**What it does:**
-- Takes the current version and creates a development version
-- Format: `version.devYYYYMMDDHHMMSS+branch.commit`
-- Automatically updates the `pyproject.toml`
-
-**Example:**
-```bash
-# If you're on branch "feature/auth" with commit "abc123"
-python scripts/version_manager.py dev
-# Result: 0.0.1.dev20250409143022
-```
-
-##### 3. Set specific version
-```bash
-python scripts/version_manager.py set --version "0.1.0"
-```
-**What it does:**
-- Changes the version to the one you specify
-- Useful for releases or to fix versions
-
-**Examples:**
-```bash
-# Release version
-python scripts/version_manager.py set --version "1.0.0"
-
-# Beta version
-python scripts/version_manager.py set --version "1.0.0b1"
-
-# Alpha version
-python scripts/version_manager.py set --version "1.0.0a1"
-```
-
-##### 4. Create Release Candidate version
-```bash
-python scripts/version_manager.py rc --version "1.0.1"
-```
-**What it does:**
-- Creates an RC version with the format `version-rc<commit>`
-- Useful for preparing releases on `release/*` branches
-
-##### 5. Validate current version
-```bash
-python scripts/version_manager.py validate
-```
-**What it does:**
-- Validates that the current version is appropriate for the branch
-- Verifies semantic format on `main` and `release/*` branches
-
-##### 6. Create dev with custom base version
-```bash
-python scripts/version_manager.py dev --base-version "0.2.0"
-```
-**What it does:**
-- Uses a different base version than the current one
-- Useful when you want to prepare a dev version for the next release
-
-### 🚀 Recommended Workflow
-
-#### For daily development:
-```bash
-# 1. View current status
-python scripts/version_manager.py show
-
-# 2. If you're on a feature branch, create dev version
-python scripts/version_manager.py dev
-
-# 3. Make your changes and commits
-git add .
-git commit -m "feat: new functionality"
-
-# 4. If you need to update the dev version (optional)
-python scripts/version_manager.py dev
-```
-
-#### For releases:
-```bash
-# 1. On main branch, set release version
-python scripts/version_manager.py set --version "1.0.0"
-
-# 2. Commit the version
-git add pyproject.toml
-git commit -m "bump: version 1.0.0"
-
-# 3. Use GitHub workflow to publish
-```
-
-#### For testing:
-```bash
-# Create specific test version
-python scripts/version_manager.py set --version "1.0.0rc1"
-```
-
-### ⚠️ PyPI Limitations
-
-PyPI doesn't allow "local versions" (versions with `+` and local identifiers). That's why we've adapted the format:
-
-- ❌ Not allowed: `1.0.0.dev20250409+feature.abc123`
-- ✅ Allowed: `1.0.0.dev20250409`
-
-**Solution for Release Candidates:**
-- We convert the commit hash (hexadecimal) to decimal
-- Example: commit `abc123` → `11256099` → version `1.0.1rc11256099`
-- This maintains commit uniqueness in a PyPI-compatible format
-
-**Result:**
-- Dev versions include unique timestamp
-- RC versions include commit hash (in decimal)
-- We maintain traceability without using local versions
-
-### 📋 Practical Use Cases
-
-**Scenario 1: Working on a feature**
-```bash
-git checkout -b feature/new-auth
-python scripts/version_manager.py dev
-# Now you have: 0.0.1.dev20250409143022
-```
-
-**Scenario 2: Preparing release**
-```bash
-git checkout main
-python scripts/version_manager.py set --version "1.0.0"
-git add pyproject.toml
-git commit -m "release: v1.0.0"
-```
-
-**Scenario 3: Preparing Release Candidate**
-```bash
-git checkout -b release/1.0.1
-python scripts/version_manager.py rc --version "1.0.1"
-# Result: 1.0.1rc12345678 (where 12345678 is the commit hash in decimal)
-```
-
-**Scenario 4: Urgent hotfix**
-```bash
-git checkout -b hotfix/critical-bug
-python scripts/version_manager.py dev --base-version "1.0.1"
-# Result: 1.0.1.dev20250409143022
-```
-
-## 🔄 Intelligent CI/CD Workflow
-
-The project includes a single intelligent workflow (`python-publish.yml`) that automatically handles different version types based on the branch:
-
-### Automatic behavior by branch:
-
-#### 🚀 `main` Branch - Production Versions
-- **Trigger**: Push to `main` or manual execution
-- **Version**: Uses exactly the version from `pyproject.toml`
-- **Validations**:
-  - ✅ Verifies it's a valid semantic version (e.g.: `1.0.0`)
-  - ✅ Verifies it doesn't already exist on PyPI
-  - ❌ Fails if it contains development suffixes (`dev`, `rc`, `alpha`, `beta`)
-- **Target**: PyPI production
-
-#### 🎯 `release/*` Branches - Release Candidates
-- **Trigger**: Push to `release/X.Y.Z` branch or manual execution
-- **Version**: `X.Y.ZrcN` where N is the commit hash in decimal (e.g.: `1.0.1rc12345678`)
-- **Validations**:
-  - ✅ Verifies that `X.Y.Z` is a valid semantic version
-  - ✅ Extracts version from branch name
-  - ✅ Uses commit hash as unique identifier
-  - ✅ PyPI-compatible format
-- **Target**: PyPI production
-- **Example**: Branch `release/1.0.1` + commit `abc123` → Version `1.0.1rc11256099`
-
-#### 🔧 Other Branches - Development Versions
-- **Trigger**: Push to any other branch or manual execution
-- **Version**: `current.devYYYYMMDDHHMMSS` (e.g.: `0.0.1.dev20250409143022`)
-- **Target**: PyPI production
-- **Note**: No local versions for PyPI compatibility
-
-### Recommended workflow:
-
-```bash
-# 1. Development on feature branch
-git checkout -b feature/new-functionality
-# Automatic version: 0.0.1.dev20250409143022+feature-new-functionality.abc123
-
-# 2. Prepare release
-git checkout -b release/1.0.0
-git push origin release/1.0.0
-# Automatic version: 1.0.0rc12345678
-
-# 3. Final release
-git checkout main
-python scripts/version_manager.py set --version "1.0.0"
-git add pyproject.toml
-git commit -m "release: v1.0.0"
-git push origin main
-# Version: 1.0.0 (with validations)
-```
-
-## 📦 Installation
-
-```bash
-pip install aigency
-```
-
-## 🛠️ Development
-
-1. Clone the repository
-2. Install development dependencies
-3. Use the version manager to manage versions during development
-
-```bash
-git clone <repo-url>
-cd aigency-lib
-pip install -e .
-```

aigency-0.0.1rc235167702.dist-info/RECORD

@@ -1,23 +0,0 @@
-aigency/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-aigency/agents/executor.py,sha256=ozT0wMwHLfyHi7bLcIPvs1gqnuj8w33SzlsSLB0W55k,5276
-aigency/agents/generator.py,sha256=I3TFZYFHF5GIH2Piuwe-7o5g7rpha4g1I93-ARqDrEk,2508
-aigency/schemas/aigency_config.py,sha256=trFOLAFCekuBtEcCofMTXw_e_d7DRMB9UYum9Ci8Qg4,491
-aigency/schemas/agent/agent.py,sha256=3Fm0tN3QG6hhxs0uo8Z2grb8SUeGS1t632Zqqcdaw18,440
-aigency/schemas/agent/model.py,sha256=8gY7xXJdpePESctRDMMFfXIZbRtHJEbIXSyvy89Bbyo,316
-aigency/schemas/agent/skills.py,sha256=5yhcoQmadaCf0Yg67PuOGDWy3ZIA-T-8dZ0uRyJw0EE,225
-aigency/schemas/agent/tools.py,sha256=VXdA0cKptAzu-4Oa0McxoI7uZtpsGXjXfAxUKzv2f4E,885
-aigency/schemas/metadata/metadata.py,sha256=wu4TM8f8eOMb40-uOLRffJjgGptW_KVOablW4EpJBLc,156
-aigency/schemas/observability/observability.py,sha256=WEeXyCrow9j2VO6HS7tOPkcKItISYsVfmHzGM-ap9nQ,320
-aigency/schemas/observability/phoenix.py,sha256=bTJ2vhe2Khtme5h5mCHEVH1o4LJAQ8GcKP6rkjPMpjo,131
-aigency/schemas/service/capabilities.py,sha256=vhMHP5pIYeOQTD-aBs79p_g5O3soHb5asfc_UhS1OFA,139
-aigency/schemas/service/interface.py,sha256=csYJhwbD9M29LrCnd1G6pBYagFauJ-WRSfrK8NIU9oI,210
-aigency/schemas/service/service.py,sha256=OajLiu5ICUFUi-M8yB9nH9jKbEuBUV6foIVcPfqx9QI,304
-aigency/tools/generator.py,sha256=sXqZBiHMCZN6iwyXBk7gTrvIN3plNEuWqwwD1heFGc8,2446
-aigency/utils/config_service.py,sha256=yN0Hj_IsDSSoTM4cYmBvR_x6vZ4bsxkoPc3Xle1SnjY,3201
-aigency/utils/logger.py,sha256=NYvEknt2BeSqn484ivaLFwP0KbAtBxDXFoJiiKiXKeI,3796
-aigency/utils/singleton.py,sha256=u5stRwgwiXRt6b2vTX4W8zuchWvQ9kbcvztQDceaF3E,313
-aigency/utils/utils.py,sha256=1eA-RxMZW6QIxhrK9TbxysxwKhGiJqjrvOk69xR-zKo,2698
-aigency-0.0.1rc235167702.dist-info/METADATA,sha256=13Xlzj93-2hRUloYGv_e1pQZ9JraZ6nxDxx8LvlEpGg,7170
-aigency-0.0.1rc235167702.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aigency-0.0.1rc235167702.dist-info/top_level.txt,sha256=nr33Htucgjs3wJFNugPV8w7b9ZgSnytxCtRiinR3eb8,8
-aigency-0.0.1rc235167702.dist-info/RECORD,,