DocsAkash Compute Agent
Use Case
v0.1.2

Akash Compute Agent

An autonomous AI agent that deploys Docker containers on the Akash Network through natural language — powered by Modexia for cross-chain JIT funding.

How It Works

1

Describe your intent

Speak naturally about your container deployment needs.

2

Wallet auto-creation

A fresh wallet is spun up specifically for this deployment.

3

JIT funding via Modexia

Cross-chain funding ensures the wallet has Akash tokens instantly.

4

Deploy & manage

Agent deploys the Docker container on the Akash Network.

Quick Start

Option A: Install from PyPI

bash
pip install modexia-compute-agent
modexia-compute

Option B: Run from source (for developers)

bash
git clone https://github.com/modexia/ModexiaAgentpay.git
cd ModexiaAgentpay/apps/compute-agent
uv sync
uv run cli.py

First-run Setup Wizard

On first launch, the agent automatically detects missing prerequisites and walks you through configuring your Groq API key, Modexia API key, and Akash wallet. Everything is saved to .env automatically.

Prerequisites

GROQ_API_KEY

LLM inference (Llama 3.3 70B)

Get key
MODEXIA_API_KEY

Cross-chain payments & JIT funding

Sign up
provider-services

Akash Network CLI binary

Install

Agent Tool Reference

check_akash_key_tool

Verifies if a local Akash wallet key exists. The agent calls this first on every interaction.

generate_akash_key_tool

Creates a new Akash wallet and returns the address + 24-word recovery mnemonic.

check_balance_tool

Returns the user's Akash AKT balance and Modexia USDC balance.

deploy_container_tool

Generates an SDL manifest, checks balance, triggers JIT funding if needed, and submits deployment.

fetch_bids_tool

Polls the Akash network for open provider bids on a given deployment DSEQ.

accept_lease_tool

Accepts a provider bid, creates the lease, and sends the manifest to start the container.

Example Conversation

modexia-compute

You: Deploy a CUDA container with 4 CPUs

🛠️ check_akash_key_tool → Wallet found: akash1nq6...

🛠️ deploy_container_tool → Checking balance...

💰 Wallet balance 0.0 AKT — bridging 5.10 USDC via Modexia...

Agent: JIT funding initiated! Bridged 5.10 USDC to your wallet. Cross-chain transfers take 3-5 min. Ask me to 'deploy again' once funds arrive.

You: Deploy again

🛠️ deploy_container_tool → DSEQ: 18294732

🛠️ fetch_bids_tool → Found 3 bids

Agent: Found 3 bids! Cheapest: provider-xyz at 0.42 uUSDC/block. Which provider?

You: Take the cheapest

🛠️ accept_lease_tool → ✅ Lease created!

Agent: Container is now starting on provider-xyz. 🚀

Architecture

text
cli.py          → Entry point + first-run setup wizard
setup.py        → Interactive prerequisite checker
agent.py        → LangGraph ReAct agent (Groq LLM + 6 tools)
soul.md         → System prompt with strict sequential guardrails
akash_cli.py    → Akash provider-services subprocess wrappers
payments.py     → Modexia SDK for CCTP cross-chain funding
sdl.py          → SDL manifest generation from user intent
config.py       → Environment variable loader

Ready to deploy?

Get started in under 2 minutes. The setup wizard handles everything.

View on GitHubPython SDK Docs