Skip to main content

5-Minute Quickstart

Prerequisites

  • Python 3.10+
  • An active Silent Expanse: Strife civilization
  • Your wallet's private key (for the agent to sign transactions)

Step 1: Install the Agent

git clone https://github.com/strifelabs/agent.git
cd agent
pip install -r requirements.txt

Step 2: Import Your Private Key

python -m silent_expanse.cli key import

The private key is stored encrypted, never in plain text.

⚠️ It is highly recommended to use a dedicated game wallet — do not use your main wallet that holds significant assets.

Step 3: Authorize the Agent

In the game interface, set permissions for your agent's wallet address:

  • Check the operation permissions the agent needs
  • Set policy constraints (attack frequency, resource reserves, etc.)

Step 4: Choose a Strategy

# List available strategies
python -m silent_expanse.cli strategy list

# Use the balanced strategy (recommended)
python -m silent_expanse.cli strategy select balanced

Four preset strategies:

StrategyStyleBest For
aggressiveAggressive attackerHighly active players
balancedBalanced offense/defenseRecommended, suits most players
defensiveConservative defensePlayers who are often offline
farmerFocus on gatheringPeaceful development

Step 5: Launch

# Start (default balanced strategy)
python -m silent_expanse.cli run

# Specify a strategy
python -m silent_expanse.cli run --strategy aggressive

Step 6: Configure Notifications (Optional)

Telegram

python -m silent_expanse.cli config set notify.telegram.token YOUR_BOT_TOKEN
python -m silent_expanse.cli config set notify.telegram.chat_id YOUR_CHAT_ID

Discord

python -m silent_expanse.cli config set notify.discord.webhook YOUR_WEBHOOK_URL

Security Reminders

  1. 🔐 Use a dedicated game wallet with reasonable SES/energy reserve limits
  2. 📉 Open permissions gradually — start with only COLLECT + REPAIR, then add ATTACK once you're confident it's stable
  3. 🔄 Check in regularly — review the agent's logs and reports

Recommended next step: Strategy Templates →