🚀 Modexia Compute Agent

Autonomous AI agent for deploying Docker containers on Akash via natural language.

The Modexia Compute Agent is a powerful Python CLI application that turns plain English descriptions into running Docker containers on the 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:

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:

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:

  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
• 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

⌨️ 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:

~/.modexia/compute.env

To forcibly re-run the setup wizard:

modexia-compute --setup

Powered by the Modexia-Verse 🌌