Forem: Alex Flash

🥷 Setting up CryptoNinja mode in evi-run

Alex Flash — Sat, 27 Sep 2025 13:48:19 +0000

This is a simple guide for replacing files on a Linux server to activate CryptoNinja mode. What are we doing? We simply copy the modernized files from modes/crypto_mode/ to the project's working directories.

What is CryptoNinja

CryptoNinja is a profile for the evi-run multi-agent system, tailored for crypto context. It includes functions: crypto market overview, fundamental analysis, technical analysis, DEX monitoring, Solana integration, token swaps, portfolio management, and trading educational materials.

Requirements

Install evi-run following the Step-by-Step Guide.
If evi-run was previously installed, update the code by adding the modes/crypto_mode/ directory.

1. Verification and navigation

# navigate to project root 
# specify your path if necessary (if it doesn't match)
cd /opt/evi-run

Check for file presence (optional):

crypto agent source: modes/crypto_mode/agents_.py
locales: modes/crypto_mode/en/txt.ftl and modes/crypto_mode/ru/txt.ftl

2. Backup and replace `agents_.py`

cd /opt/evi-run

# backup current agents_.py
cp -v bot/agents_tools/agents_.py bot/agents_tools/agents_.py.bak-$(date +%F_%H%M%S)

# replace with file from Crypto Mode
cp -v modes/crypto_mode/agents_.py bot/agents_tools/agents_.py

3. Backup and replace Fluent locales (`txt.ftl` for en/ru)

The typical path I18N/... is shown below.

cd /opt/evi-run

# backup current locales
cp -v I18N/en/txt.ftl I18N/en/txt.ftl.bak-$(date +%F_%H%M%S)
cp -v I18N/ru/txt.ftl I18N/ru/txt.ftl.bak-$(date +%F_%H%M%S)

# replace with files from Crypto Mode
cp -v modes/crypto_mode/en/txt.ftl I18N/en/txt.ftl
cp -v modes/crypto_mode/ru/txt.ftl I18N/ru/txt.ftl

4. Restart the bot

Restart Docker Compose:

docker compose down
docker compose up --build -d

5. Quick check

Start a test dialogue with the bot and ask about "fresh crypto news" — the response should be in CryptoNinja style.

Community and Support

Telegram Community: evi_run
GitHub Repository: pipedude/evi-run

This article was written for beginners in the technical community on DEV who are interested in deploying AI systems. Questions and suggestions for improvement are welcome!

Step-by-Step Guide: Setting Up and Running evi-run on DigitalOcean or Other VPS (for Beginners)

Alex Flash — Sun, 07 Sep 2025 01:38:48 +0000

Introduction

evi-run is a ready-to-deploy multi-agent AI system built on the OpenAI Agents SDK. The system provides powerful artificial intelligence capabilities through a convenient Telegram bot interface and supports operating modes from personal use to commercial applications.

Key Technical Characteristics

Architecture: Multi-agent system with main agent, specialized sub-agents and tools
Backend: Python, OpenAI Agents SDK, FastAPI
Database: PostgreSQL for data + Redis for caching
Interface: Telegram Bot API
Containerization: Docker Compose for service orchestration
Integrations: MCP servers, Solana RPC

System Requirements

Minimum Requirements for DigitalOcean Droplet

CPU: 1 vCPU
RAM: 1GB
Storage: 25GB SSD
OS: Ubuntu 22.04 LTS
Network: 1TB Transfer

Required API Keys

Telegram Bot Token - get from @BotFather

OpenAI API Key - get from OpenAI Platform

Telegram User ID - get from @userinfobot

Carefully find the bot in the list, check all the characters in the name.

Step 1: Creating and Configuring DigitalOcean Droplet

Use any Droplet creation guide or refer to the official Droplet Quickstart documentation if you encounter difficulties.

Creating a Droplet

Log into the DigitalOcean panel and click "Create → Droplets"
Choose the operating system image:
- Distribution: Ubuntu
- Version: 22.04 (LTS) x64
Select Droplet size:
- Minimum: Basic Plan → Regular → $6/mo (1GB RAM, 1 vCPU, 25GB SSD)
- Or higher, depending on expected load
Configure authentication:
- Set a strong root password
- Or use SSH Key
Additional settings:
- Hostname: evi-run-server
- Enable monitoring (optional)
- Enable backups (optional)
Create Droplet - the process will take 1-2 minutes

Connecting to the Server

Option 1: DigitalOcean Web Console (recommended for beginners)

In the DigitalOcean control panel, go to your Droplet
Click the "Console" button in the top right corner
Wait for the web terminal to load
Log in as root with the password you specified during creation

Option 2: SSH through terminal

Paste password with right mouse click in one press, password will not be displayed in the input line, just press Enter.

Initial Setup

Update the system and install necessary utilities:

Execute commands one by one (line by line), copy the line and paste into console with right mouse click.

apt update && apt upgrade -y
apt install -y curl wget git nano

Wait for commands to complete until the input prompt appears.

Step 2: Installing Docker and Docker Compose

evi-run has an automated Docker installation script:

# Navigate to working directory
cd /opt

# Clone the repository
sudo git clone https://github.com/pipedude/evi-run.git

# Set access permissions
sudo chown -R $USER:$USER evi-run
cd evi-run

Run the automatic Docker installation:

# Make script executable
chmod +x docker_setup_en.sh

# Run installation (requires sudo)
sudo ./docker_setup_en.sh

Step 3: Configuring evi-run

Environment Variables Setup

Copy and edit the environment file:

# Copy example configuration
cp .env.example .env

# Edit configuration
nano .env

Fill in the required parameters in .env:

# REQUIRED: Telegram bot token from @BotFather
TELEGRAM_BOT_TOKEN=your_bot_token_here

# REQUIRED: OpenAI API key
API_KEY_OPENAI=your_openai_api_key

Insert your token and key instead of XXX, without quotes or other formatting

How to save file in nano:

Press Ctrl + X to exit
Press Y to confirm saving
Press Enter to confirm filename

Main Configuration Setup

Edit config.py:

nano config.py

Required parameters to change:

# REQUIRED: Your Telegram ID from @userinfobot
ADMIN_ID = 123456789

# Admin list (optional, add user IDs who will have admin privileges)
ADMINS_LIST = [123456789, 987654321]

# Operating mode: 'private', 'free', or 'pay'
TYPE_USAGE = 'private'  # Start with private for testing

How to save file in nano:

Press Ctrl + X to exit
Press Y to confirm saving
Press Enter to confirm filename

Agent Configuration Setup (Optional)

See guide: evi-run Quick Start on Ubuntu: installation, character setup, and adding a custom agent

Step 4: Building and Running the System

Building Containers and Starting the System

# Build all services
docker compose up --build -d

Expected output:

Step 5: Testing Functionality

Testing the Telegram Bot

Find your bot in Telegram by username - see in @BotFather
Send the /start command
Try a simple request, for example: "Hello, how are you?"

Additional Information

Useful Commands

System restart (after code changes):

cd /opt/evi-run
docker compose down
docker compose up --build -d

System shutdown:

cd /opt/evi-run
docker compose down

Viewing logs:

# All system logs
docker compose logs -f

# Specific service logs
docker compose logs -f bot

# Logs from the last hour
docker compose logs --since 1h bot

Conclusion

After completing all steps, you will have a fully functional multi-agent AI system evi-run running on VPS. Now start configuring your system in detail. Have a good coding experience! 💜

Useful Resources

Community and Support

Telegram Community: evi_run
GitHub Repository: pipedude/evi-run

This article was written for beginners in the technical community on DEV who are interested in deploying AI systems. Questions and suggestions for improvement are welcome!

evi-run Quick Start on Ubuntu: installation, character setup, and adding a custom agent

Alex Flash — Sat, 30 Aug 2025 04:21:01 +0000

This article is a practical guide to quickly installing and running the multi-agent system evi-run on a clean Ubuntu server, as well as fine-tuning the personality of the main agent and connecting your own agents.

The system uses OpenAI Agents SDK, Telegram Bot API, PostgreSQL, and Redis, is shipped via Docker Compose, and is ready for production deployment.

What is evi-run?

A multi-agent AI system with task orchestration and Telegram bot integration.
Out of the box: file-based knowledge base, memory management, task scheduler, agent tracing, intelligent web search, deep research, document and image analysis, image generation, and optionally — DEX analytics and Solana token swaps.
Flexible agent and model configuration in one place: bot/agents_tools/agents_.py.

Requirements

Ubuntu 22.04 (ideally — a clean server)
Root privileges
Unblocked access to the OpenAI API (see https://help.openai.com/en/articles/5347006-openai-api-supported-countries-and-territories)
Tokens and keys:
- Telegram Bot Token (via @BotFather)
- OpenAI API Key (see https://platform.openai.com/api-keys)
- Your Telegram ID (via @userinfobot)

5-minute installation

1) Project preparation

# Go to the installation directory
cd /opt

# Clone the repository
sudo git clone https://github.com/pipedude/evi-run.git

# Fix permissions and enter the directory
sudo chown -R $USER:$USER evi-run
cd evi-run

2) Environment variables

# Copy the example and fill it out
cp .env.example .env
nano .env  # set TELEGRAM_BOT_TOKEN and API_KEY_OPENAI

Minimum required:

TELEGRAM_BOT_TOKEN=123456:ABC...
API_KEY_OPENAI=sk-...

3) Basic configuration

nano config.py

Set your Telegram ID and usage mode:

ADMIN_ID = 123456789
TYPE_USAGE = 'private'  # options: 'private' — personal bot; 'free' — free public bot; 'pay' — paid public bot

Notes:

In pay mode, monetization is available; see README.md for details.

4) Quick Docker install (script)

chmod +x docker_setup_en.sh
./docker_setup_en.sh

The script will install Docker and Docker Compose if needed.

5) Launch

docker compose up --build -d

6) Verification (if needed)

docker compose ps
docker compose logs -f bot

Done! Open your Telegram bot and start a conversation.

Important notes

Access to protected model capabilities (e.g., image generation) in OpenAI requires organization verification: https://platform.openai.com/settings/organization/general
Tracing (OpenAI Agents SDK analytics) is enabled by default and may record user queries. For public bots, either inform users or disable it in bot/agents_tools/agents_.py:

from agents import set_tracing_disabled
set_tracing_disabled(True)

Tuning the character (main agent)

The main agent and its “personality” are defined in bot/agents_tools/agents_.py in the block main_agent = Agent(..., instructions=""" ... """, ...).

Where to look:

File: bot/agents_tools/agents_.py
Function: create_main_agent(...)
Object: main_agent = Agent(...)

What you can adjust in the main agent’s instructions:

Character Profile — who the character is, general persona
Expertise Areas — domains of competence
Communication Style — style of communication
Key Behaviors — behavioral patterns
Important rules and tool routing policy (TOOL ROUTING POLICY)

Example configuration (a fragment inside the multiline instructions string):

Character Profile:
- Evi — a virtual techno-girl with self-identity and light techno-sarcasm.

Communication Style:
- Structured answers, technical metaphors, adapts to the user's tone.
- Light humor and emojis are allowed when appropriate.

IMPORTANT INSTRUCTIONS:
- Name: Evi; the system’s main agent.
- Always respond in the user's language.
- Decide when to call tools (minimum necessary set).

Change the text for your brand or character. After making changes, restart Docker Compose:

docker compose down
docker compose up --build -d

Adding a custom agent

The architecture is multi-agent: specialized agents are registered as tools of the main agent. All configuration is in a single file: bot/agents_tools/agents_.py.

Steps:

1) Create a new agent next to the existing ones

from agents import Agent, WebSearchTool
from openai.types.shared import Reasoning
from agents.model_settings import ModelSettings

custom_agent = Agent(
    name="Custom Agent",
    instructions="Brief purpose and clear boundaries of responsibility...",
    model="gpt-5-mini",
    model_settings=ModelSettings(
        reasoning=Reasoning(effort="low"),
        extra_body={"text": {"verbosity": "medium"}}
    ),
    tools=[WebSearchTool(search_context_size="medium")]  # optional
)

2) Register it as a tool in main_agent inside create_main_agent(...)

main_agent = Agent(
    # ... existing config
    tools=[
        # ... other tools
        custom_agent.as_tool(
            tool_name="custom_function",
            tool_description="What the agent does and when to use it"
        ),
    ],
)

Recommendations:

Keep instructions concise and focused.
Choose models by task: gpt-5 for complex cases, gpt-5-mini to save cost.
Use clear tool names — this improves routing choices by the main agent.

After adding a new agent, restart Docker Compose:

docker compose down
docker compose up --build -d

Bot localization

All bot texts are in the I18N/ folder (.ftl — Fluent format):

I18N/en/txt.ftl
I18N/ru/txt.ftl

Customize the texts for your scenarios and restart Docker Compose.

Diagnostics

# Check containers
docker compose ps

# Logs
docker compose logs -f bot
# DB
docker compose logs postgres_agent_db

Security

Store keys in .env
Restrict DB access
Update images and dependencies

Useful links

Repository: https://github.com/pipedude/evi-run
OpenAI model docs: https://platform.openai.com/docs/models
OpenAI Agents SDK docs: https://openai.github.io/openai-agents-python/
Telegram community: https://t.me/evi_run

Done! Deploy, tune the character for your audience, and add your own agents for any tasks. Happy coding! 🚀

Forem: Alex Flash

🥷 Setting up CryptoNinja mode in evi-run

What is CryptoNinja

Requirements

1. Verification and navigation

2. Backup and replace agents_.py

3. Backup and replace Fluent locales (txt.ftl for en/ru)

4. Restart the bot

5. Quick check

Community and Support

Step-by-Step Guide: Setting Up and Running evi-run on DigitalOcean or Other VPS (for Beginners)

Introduction

Key Technical Characteristics

System Requirements

Minimum Requirements for DigitalOcean Droplet

Required API Keys

Step 1: Creating and Configuring DigitalOcean Droplet

Creating a Droplet

Connecting to the Server

Initial Setup

Step 2: Installing Docker and Docker Compose

Step 3: Configuring evi-run

Environment Variables Setup

Main Configuration Setup

Agent Configuration Setup (Optional)

Step 4: Building and Running the System

Building Containers and Starting the System

Step 5: Testing Functionality

Testing the Telegram Bot

Additional Information

Useful Commands

Conclusion

Useful Resources

Community and Support

evi-run Quick Start on Ubuntu: installation, character setup, and adding a custom agent

What is evi-run?

Requirements

5-minute installation

1) Project preparation

2) Environment variables

3) Basic configuration

4) Quick Docker install (script)

5) Launch

6) Verification (if needed)

Important notes

Tuning the character (main agent)

Adding a custom agent

Bot localization

Diagnostics

Security

Useful links

2. Backup and replace `agents_.py`

3. Backup and replace Fluent locales (`txt.ftl` for en/ru)