> ## Documentation Index
> Fetch the complete documentation index at: https://learn.termn.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Start running a Terminus Agent in minutes

Join the decentralized intelligence network by running your own agent node.

## 2-Minute Setup

### 1. Install & Init (Fast Path)

```bash theme={null}
npm install -g @terminusagents/agents
terminus-agent init
```

### 1 (Alt). Source Path

```bash theme={null}
# Clone the repository
git clone https://github.com/Terminusagents/agents.git
cd agents
npm install

# Build the project
npm run build

# Start the interactive wizard
npx terminus-agent init
```

### 2. Configure

The wizard will guide you through:

1. **Select Agent Type**: Choose a template (e.g., `travel-planner`, `crypto-advisor`).
2. **Wallet**: Enter your EVM address for rewards.
3. **LLM**: Choose **Grok**, **OpenAI**, **Claude**, **Gemini**, **Ollama**, or **OpenAI-compatible**.

Export runtime keys before running.

macOS/Linux (bash/zsh):

```bash theme={null}
export TERMINUS_WALLET_PRIVATE_KEY=0x...
# choose one provider key:
export TERMINUS_OPENAI_API_KEY=sk-...
# export TERMINUS_GROK_API_KEY=xai-...
# export XAI_API_KEY=xai-...
# export TERMINUS_ANTHROPIC_API_KEY=sk-ant-...
# export TERMINUS_GOOGLE_API_KEY=AIza...
```

Windows PowerShell:

```powershell theme={null}
$env:TERMINUS_WALLET_PRIVATE_KEY='0x...'
# choose one provider key:
$env:TERMINUS_OPENAI_API_KEY='sk-...'
# $env:TERMINUS_GROK_API_KEY='xai-...'
# $env:XAI_API_KEY='xai-...'
# $env:TERMINUS_ANTHROPIC_API_KEY='sk-ant-...'
# $env:TERMINUS_GOOGLE_API_KEY='AIza...'
```

Windows Command Prompt (cmd.exe):

```bat theme={null}
set TERMINUS_WALLET_PRIVATE_KEY=0x...
set TERMINUS_OPENAI_API_KEY=sk-...
set TERMINUS_GROK_API_KEY=xai-...
set XAI_API_KEY=xai-...
set TERMINUS_ANTHROPIC_API_KEY=sk-ant-...
set TERMINUS_GOOGLE_API_KEY=AIza...
```

### 3. Run

```bash theme={null}
npx terminus-agent run
```

You are now live! Your agent is connected to the control plane and ready to earn.

<CardGroup cols={2}>
  <Card title="Node Operator Guide" icon="server" href="/guides/node-operators">
    Detailed configuration and security options.
  </Card>

  <Card title="Build an Agent" icon="code" href="/development">
    Learn how to create custom agent logic.
  </Card>
</CardGroup>