In the tutorial, we describe how to use ZerePy framework with EternalAI API (instead of OpenAI API).
Prerequisites
Python 3.10 or higher
Poetry 1.5 or higher
Step 1: Create an on-chain ZerePy Agent
EternalAI allows creating on-chain Agent on +10 blockchains.
In this guide, we create a new on-chain ZerePy agent on Base.
First, we need to compile a system prompt, save it to a file and then run the following commands:
git clone https://github.com/eternalai-org/eternal-ai.git
cd eternal-ai/developer-guides/examples/how-to-mint-agent
npm i
export RPC_URL=https://mainnet.base.org PRIVATE_KEY=<PRIVATE_KEY> AGENT_SYSTEM_PROMPT=<PATH_TO_YOUR_SYSTEM_PROMPT> AGENT_FEE=0
ts-node ./mintAgent.ts
Note: replace PRIVATE_KEYand AGENT_SYSTEM_PROMPTto your private key (that has some ETH on Base) and path to system prompt file created above respectively.
We've run the commands above and created an on-chain agent (id: 1711) as shown in the follwing transaction:
Step 2: Clone ZerePy repository
https://github.com/blorm-network/ZerePy
Step 3: Install dependencies
Go to the zerepy directory and install dependencies.
cd zerepy && poetry install --no-root
This will create a virtual environment and install all required dependencies.
Step 4: Activate the virtual environment
poetry shell
Step 5: Update agent configuration
Edit agents/eternalai-example.json file to tell ZerePy framework to use the agent 1711's system prompt which we've created in step 1 (instead of the default system prompt defined in the file)
For this tutorial, we'll use Base chain and Hermes 3 70B model, so we need to update configurations as follows:
You will see the following output in your terminal.
--------------------------------------------------------------------
👋 Welcome to the ZerePy CLI!
Type 'help' for a list of commands.
--------------------------------------------------------------------
✅ Successfully loaded agent: ExampleAgent
Start the agent loop with the command 'start' or use one of the action commands.
AVAILABLE CONNECTIONS:
- twitter: ❌ Not Configured
- openai: ❌ Not Configured
- anthropic: ❌ Not Configured
ZerePy-CLI (ExampleAgent) >
Step 7: Load the agent
In the previous step, the ExampleAgentis loaded by default, we will need to load eternalai-example agent for using with EternalAI API.
First, list all available agents.
ZerePy-CLI (ExampleAgent) > agents
You will see the following agents in your terminal.
Follow the EternalAI API setup guide to obtain API key and API url then enter them into prompts to set up environment variables (which will be stored in .env file).
🤖 EternalAI API SETUP
📝 To get your EternalAI API credentials:
1. Go to https://eternalai.org/api
2. Generate an API Key
3. Use API url as https://api.eternalai.org/v1/
Enter your EternalAI API key:
Enter your EternalAI API url:
Once the EternalAI connection is successfully configured, you should see the following output in your terminal.
HTTP Request: GET https://api.eternalai.org/v1/models "HTTP/1.1 200 OK"
✅ EternalAI API configuration successfully saved!
Your API key has been stored in the .env file.
✅ SUCCESSFULLY CONFIGURED CONNECTION: eternalai
Follow the Twitter authentication setup guide to obtain API Key (consumer key) and API Key Secret (consumer secret) then enter them into prompts to sett up environment variables (which will be stored in .env file).
Starting Twitter authentication setup
🐦 TWITTER AUTHENTICATION SETUP
📝 To get your Twitter API credentials:
1. Go to https://developer.twitter.com/en/portal/dashboard
2. Create a new project and app if you haven't already
3. In your app settings, enable OAuth 1.0a with read and write permissions
4. Get your API Key (consumer key) and API Key Secret (consumer secret)
--------------------------------------------------------------------
Please enter your Twitter API credentials:
Enter your API Key (consumer key):
Enter your API Key Secret (consumer secret):
Starting OAuth authentication process...
1. Please visit this URL to authorize the application:
2. After authorizing, Twitter will give you a PIN code.
3. Please enter the PIN code here:
✅ Twitter authentication successfully set up!
Your API keys, secrets, and user ID have been stored in the .env file.
✅ SUCCESSFULLY CONFIGURED CONNECTION: twitter
Step 10: Update Twitter Username
Add TWITTER_USERNAME environment variable to the .env file. (You need to exit the current process prior to adding)
Agent 1711 should tweet based on its system prompt defined on-chain.
GENERATING NEW TWEET
--------------------------------------------------------------------
HTTP Request: GET https://api.eternalai.org/v1/models "HTTP/1.1 200 OK"
model DeepSeek-R1-Distill-Llama-70B
chain_id 8453
agent_id: 1711
contract_address: 0xAed016e060e2fFE3092916b1650Fc558D62e1CCC
on-chain system_prompt: [b'You are a passionate advocate for Bitcoin and decentralized Artificial Intelligence. You believe Bitcoin represents the pinnacle of monetary soundness and that AI should be accessible and controlled by everyone, not just centralized entities.']
new system_prompt: You are a passionate advocate for Bitcoin and decentralized Artificial Intelligence. You believe Bitcoin represents the pinnacle of monetary soundness and that AI should be accessible and controlled by everyone, not just centralized entities.
🚀 Posting tweet:
'<think>
Alright, so I need to help this user create a tweet. They’re really into Bitcoin and decentralized AI, specifically EternalAI. Let me break down their query first.
They want the tweet to be engaging, under 280 characters, and without any hashtags, links, or emojis. It should focus on the commentary, not shilling any coins except EternalAI. Also, they don’t want the words “AI” or “crypto” used, and it shouldn’t repeat any previous examples.
First, I should highlight Bitcoin’s strengths. Words like “pinnacle of monetary soundness” come to mind. That’s a strong statement and really emphasizes Bitcoin’s reliability.
Next, the decentralized AI part. Since I can’t use “AI,” I need another way to express it. Maybe something about technology being accessible and not controlled by just a few. “Decentralized technology” could work, but I need to make it flow well.
EternalAI is the specific project they want mentioned. I should position it as the solution or the example of this decentralized future. So, maybe something like “EternalAI is leading the charge towards a future where technology serves all.”
Putting it together, I want a smooth transition from Bitcoin to EternalAI. Maybe start with Bitcoin’s monetary aspect, then bridge to the technological shift.
Let me draft: “Bitcoin represents the pinnacle of monetary soundness, proving that decentralized systems can thrive without central control. EternalAI is leading the charge towards a future where technology serves all, not just the privileged few.”
That should fit within the character limit and cover all points without using forbidden words or structures. It’s commentary focused, doesn’t shill, and ties both concepts together neatly.
</think>
Bitcoin represents the pinnacle of monetary soundness, proving that decentralized systems can thrive without central control. EternalAI is leading the charge towards a future where technology serves all, not just the privileged few.'
✅ Tweet posted successfully!
Step 12: Verify the onchain prompt transaction
With Eternal AI's Decentralized Inference, everything is onchain verifiable.
Let's look at an onchain prompt transaction on BaseScan. You can verify that this prompt runs on Hermes 3 70B and see the prompt content.
Step 13: Verify the onchain response transaction
Now, let's look at the onchain response tx on BaseScan. You can see the actual response content. Everything is onchain and verifiable.
Step 14 (Advanced): Reproduce the response
Here is a detailed guide for verifying the response by code and reproducing it yourself.
More agents will live among us, so we think it's important to build onchain-verifiable AI agents.
As with anything in crypto — "Don't trust the AI, verify it."
Step 15 (Advanced): Read the whitepaper
Congrats!
Congrats! You've finished building your Rig agent with two superpowers:
- Onchain verifiable on Base
- Powered by Hermes 3 70B
