Metadata-Version: 2.3
Name: ambientagi
Version: 0.2.0
Summary: Your all-in-one SDK to automate multi-agent tasks
Author: ambientagi admin@ambientagi.com
Requires-Python: >=3.11,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: APScheduler (>=3.11.0)
Requires-Dist: Markdown (==3.7)
Requires-Dist: boto3 (>=1.28.0,<2.0.0)
Requires-Dist: browser-use (==0.1.29)
Requires-Dist: eth-account[secure] (==0.13.7)
Requires-Dist: firecrawl-py (>=1.10.2)
Requires-Dist: gradio (==5.10.0)
Requires-Dist: json-repair
Requires-Dist: langchain-mistralai (==0.2.4)
Requires-Dist: openai (==1.66.3)
Requires-Dist: openai-agents (==0.0.4)
Requires-Dist: playwright (>=1.49.1,<2.0.0)
Requires-Dist: pydantic (>=2.0,<3.0)
Requires-Dist: pydantic-settings (>=2.7.1,<3.0.0)
Requires-Dist: pyperclip (==1.9.0)
Requires-Dist: python-dotenv (==1.0.1)
Requires-Dist: python-logging-loki (==0.3.1)
Requires-Dist: reportlab (==4.3.1)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: requests-oauthlib (>=2.0.0,<3.0.0)
Description-Content-Type: text/markdown


# 🌟 AmbientAGI: Build Token-Rewarded AI Agents

AmbientAGI merges **AI orchestration** with **crypto token rewards**, enabling users to:

1. 🚀 **Create and deploy** specialized AI agents in a **multi-tenant** environment.
2. 💰 **Mint tokens** on major blockchains (Solana or Ethereum) to reward agent activity.
3. 🎨 **Generate 3D/visual media** for each agent, turning them into branded, interactive personas.
4. 🏆 **Earn from agent usage**, verified on-chain to ensure transparency and authenticity.
5. 🔮 **Expand** into a broad set of real-world and crypto-focused use cases: job search assistance, analyzing trending coins, whale-tracking, yield farming alerts, and more.

---

## ✨ Features

1. 🏗️ **Multi-Tenant Orchestrator**: Host and manage user agents with unified logs and a centralized database.
2. 🐍 **Python Library**: Develop custom agent behaviors with built-in schedulers and blockchain hooks.
3. 🪙 **Token Minting**: Reward users by minting tokens on Solana or Ethereum for agent usage.
4. 🖼️ **3D/Visual Media Integration**: Generate and mint unique 3D/video representations of agents as NFTs.
5. 🔗 **Crypto Integration**: Leverage DeFi, staking, and wallet integration for a seamless crypto experience.

---

## 1. 🏢 Multi-Tenant Orchestrator

### 🛠️ Architecture

- **Central Orchestrator**: Manages all agents and ensures task scheduling and execution.
- **Database**: Stores agent configurations (e.g., name, wallet address, schedule, commands).
- **Scheduler**: Handles task scheduling using tools like APScheduler or Celery.
- **On-Chain Usage**: Logs agent activities on IPFS and references them in blockchain contracts for transparency.

## ⚡️ Why AmbientAGI?

- **Real-world agent orchestration**: Async schedulers, agent state, and custom prompts.
- **Multi-agent setups**: Plug-and-play modular agents (triage, trading, data fetchers, etc.).
- **Web UI**: Run agents visually using a Gradio-based interface with streaming feedback.
- **Social + On-Chain Output**: Agents that tweet, message, browse, or mint tokens—all from Python.

---

## 🧱 Core Features

| Feature | Description |
|--------|-------------|
| **Agent SDK** | `AmbientAgentService` for creating and managing agents via Python |
| **Async Web & Social Bots** | Telegram, Twitter, Browser, Email integration |
| **Scheduler Support** | Schedule agent tasks using APScheduler |
| **Token Minting** | Mint ETH/SOL tokens tied to agent usage |
| **NFT Media Hooks** | Attach 3D/video/NFT identity to agents |
| **WebUI** | Control and visualize browser agents from a Gradio dashboard |

---

## 💬 Agent Types

| Type | Description |
|------|-------------|
| **BrowserAgent** | Controls a headless browser via Playwright |
| **TwitterAgent** | Tweets, replies, uploads media |
| **TelegramAgent** | Posts in groups/channels, responds to mentions |
| **FirecrawlAgent** | Scrapes and crawls web content |
| **EmailAgent** | Sends messages via Gmail/SMTP |
| **BlockchainAgent** | Deploys tokens and interacts with Ethereum/Solana |

Visit https://github.com/AmbientAGI/ambientagi on how to use it with examples.

