为什么值得关注

它无须任何外部 API 密钥即可实现完全链上的自主 AI 代理，将调度、融资和执行全部交由智能合约完成。

适合谁使用

探索链上 AI 代理的开发者
构建自主合约的 Web3 爱好者
Ritual 测试网用户
测试自给自足智能合约的 Solidity 开发者

典型使用场景

部署一个定期自动发布内容的链上生成器
在链上运行重复的数据分析或预测任务
测试自筹资金型智能合约代理的可行性
在区块链环境中尝试基于 TEE 的 AI 执行

项目优势

一条命令即可部署代理，除提示词外无需任何手动配置
无需外部 API 密钥——模型通过 Ritual 网关路由
加密的密钥库安全存储私钥，不会暴露在 .env 文件中
提供清晰的状态检查与警告，避免为已死亡的代理充值

使用前须知

管理功能（重启、启动、提现、停止）因代理合约漏洞而损坏——代理死亡后资金无法恢复或重启
仅支持 Ritual 测试网及测试网 RITUAL，未提及主网支持
该软件为测试网软件且未经审计，锁死在死亡代理中的资金将永久丢失

README 快速开始

Ritual Sovereign Agent

Deploy a recurring, sovereign AI agent on Ritual testnet with one command. No API keys.

⭐ What is this? ⭐

A sovereign agent is a smart contract that wakes itself on a schedule. On every wake it runs an AI agent inside a secure enclave (TEE), pays for that run from its own on-chain wallet, and keeps going until the money runs out. It lives entirely on-chain.

📋 Prerequisites 📋

You need three things. The script installs everything else for you (foundry, uv, and - on Linux/WSL - curl).

git - to download the code. Most systems already have it; if git --version fails, install it (see below).
A wallet on Ritual testnet with a little RITUAL in it. Create one in MetaMask or Rabby, then get free testnet RITUAL from the faucet: https://faucet.ritualfoundation.org
That wallet's private key (use a throwaway testnet wallet - never a real one). You paste it once, when the script asks.

Installing git (skip if git --version already works):

Windows: install Git for Windows - it also bundles Git Bash and curl - or run winget install Git.Git.
macOS: xcode-select --install (or brew install git).
Linux / WSL: sudo apt install git (Debian/Ubuntu), or your distro's package manager.

🏃 Quick Start 🏃

Step 1 - Get the code

git clone https://github.com/zunmax/ritual-agent-deployment.git
cd ritual-agent-deployment

Step 2 - Configure

cp .env.example .env

There is nothing you must edit - the defaults work. PROMPT is the task your agent runs on every wake, so change it to anything you like.

Step 3 - Deploy

On Windows, using PowerShell 7 (pwsh):

pwsh -ExecutionPolicy Bypass -File run.ps1

On Windows, using Windows PowerShell 5.1 (powershell, which is preinstalled on every Windows):

powershell -ExecutionPolicy Bypass -File run.ps1

-ExecutionPolicy Bypass lets the script run without changing any system setting (Windows blocks unsigned scripts by default); it applies only to this one launch.

On Linux / macOS / Git Bash / WSL:

bash run.sh

🛠 Managing your agents 🛠

Each agent is its own contract at a fixed address (your wallet plus a salt). On Windows, use pwsh -ExecutionPolicy Bypass -File run.ps1 in place of bash run.sh in the ex

项目描述

Deploy a recurring, self-funding sovereign AI agent on Ritual testnet with one command.

ritual-agent-deployment