Metadata-Version: 2.4
Name: modexia-compute-agent
Version: 0.1.2
Summary: Autonomous AI agent for deploying containers on Akash Network via Modexia AgentPay
Author-email: Modexia <hello@modexia.software>
Project-URL: Repository, https://github.com/modexia/modexia-compute-agent
Requires-Python: >=3.14
Description-Content-Type: text/markdown
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: langchain-core>=1.2.23
Requires-Dist: langchain-groq>=1.1.2
Requires-Dist: langgraph>=1.1.4
Requires-Dist: modexiaagentpay>=0.1.0
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: rich>=14.3.3

<div align="center">
  <img src="https://modexia.software/favicon.ico" alt="Modexia Logo" width="80" height="80">
  <br>
  <h1>🚀 Modexia Compute Agent</h1>
  <p><b>Autonomous AI agent for deploying Docker containers on Akash via natural language.</b></p>

  [![PyPI](https://img.shields.io/pypi/v/modexia-compute-agent.svg)](https://pypi.org/project/modexia-compute-agent/)
  [![Python versions](https://img.shields.io/pypi/pyversions/modexia-compute-agent.svg)](https://pypi.python.org/pypi/modexia-compute-agent)
  [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

</div>

The **Modexia Compute Agent** is a powerful Python CLI application that turns plain English descriptions into running Docker containers on the [Akash Network](https://akash.network).

Powered by the **Modexia AgentPay** engine over the Squid Router, this agent features *true abstract deployments*. Simply instruct the agent to deploy a container, and it will handle the SDL generation, Akash wallet creation, and **Just-In-Time (JIT) USDT/USDC cross-chain funding + Gas Fee swaps** completely autonomously.

---

## ✨ Features

* **🗣️ Conversational Deployments:** Describe your container, CPU, RAM, and storage needs in plain English.
* **🧠 Llama 70B Orchestration:** Uses Groq's high-speed inference to flawlessly orchestrate complex blockchain provider interactions.
* **💳 JIT Cross-Chain Funding:** No AKT? No problem. The agent automatically bridges USDC from your Modexia Vault natively covering AKT gas fees, ensuring seamless workflow.
* **🔮 Oracle Vibe GUI:** A sleek, beautiful, minimalist `rich` UI ensuring deploying compute feels incredibly satisfying.

---

## ⚡ Installation

Install globally using `pip` or `pipx`:

```bash
pip install modexia-compute-agent
```

---

## 🚀 Quick Start & API Setup

Upon running the CLI for the first time, our interactive **Setup Wizard** will launch immediately and seamlessly guide you through connecting all necessary services over 4 quick steps.

Simply run:
```bash
modexia-compute
```

### What You'll Need During Setup:

#### 1. Akash CLI (`provider-services`)
We rely on the official Akash binary to securely generate wallets and sign transactions purely on your local machine (your mnemonic seed phrase is safely stored exclusively in `~/.modexia/`).

* **Linux / macOS Installation:**
  ```bash
  curl -sSfL https://raw.githubusercontent.com/akash-network/provider/main/install.sh | bash
  ```

#### 2. Modexia AgentPay API Key
Modexia is the payment orchestration layer that allows the agent to intelligently fund your Akash wallet from external chains.

* Sign up at [Modexia.software](https://modexia.software)
* Fund your Vault with USDC (on Base).
* Create a Developer API Key (`mx_live_...`).

#### 3. Groq API Key
The agent's "brain" is powered by extremely fast LLaMA models. 
* Free keys at [console.groq.com/keys](https://console.groq.com/keys)

---

## ⌨️ How It Works

Type your intent in plain English, and the oracle goes to work:

```
> Spin up an NGINX frontend cache on a fast server with 2 CPUs and 4GB RAM.
```

1. **Manifest Generation:** The LLM instantly writes a verified `SDL (deploy.yaml)` for Akash.
2. **Auto-Fund Engine Check:** Identifies an empty Akash wallet and bridges exactly `$5.10 USDC` required for escrow and AKT gas natively from your Modexia Vault.
3. **Provider Bidding:** Connects to Akash, polls live decentralized datacenters, and reports back.
4. **Approval Loop:** Asks the human precisely which provider is preferred.
5. **Liftoff:** Container initializes and exposes the assigned NodePort/URI securely!

---

## ⚙️ Modifying Configuration Later

At any time, you can edit your setup or switch APIs. Your configuration is securely stored off-package in your home directory:

```bash
~/.modexia/compute.env
```

To forcibly re-run the setup wizard:
```bash
modexia-compute --setup
```

---

*Powered by the Modexia-Verse* 🌌
