Getting Started

Learn how to install and configure Aura OS to become your AI Commander for Web3.

What is Aura OS?

Aura OS is an autonomous AI agent that helps you manage your Web3 assets through natural language commands. Whether you want to check balances, send tokens, or automate complex trading strategies, Aura OS understands your intent and executes with precision.

✨ Key Features

  • AI Interpreter — Natural language understanding for Web3 commands
  • Secure Vault — AES-256 encrypted local key storage
  • CLI Power — Background automation that browsers can't handle
  • Multi-Chain — Ethereum, Base, zkSync Era, and more
  • Forensic Tools — In-depth transaction analysis (aura tx)
  • Aura Scripts — Build custom Web3 automations

Prerequisites

Before you begin, make sure you have the following installed:

  • Node.js v18.0 or higher
  • npm or pnpm
  • OpenAI API Key (for AI features)

Installation

Step 1: Install Aura OS globally

terminal
npm install -g @felizz23/aura-os

Step 2: Set up your environment

Create a .env file in your home directory:

.env
# OpenAI API Key for AI features
OPENAI_API_KEY=sk-your-api-key-here

Step 3: Initialize Aura OS

Run the setup command to configure your wallet:

terminal
aura setup
Welcome to Aura OS - AI Agent Manager
? Enter your private key (will be encrypted locally): ********
? Set Master Password to protect your wallet: ********
✓ Setup complete! Your private key is protected by AES-256.
⚠️

Security Note

Your private key is encrypted with AES-256 and stored locally on your device. It never leaves your machine. However, always use a dedicated wallet for testing.

Quick Commands

Once set up, you can start using Aura OS with natural language:

aura chat "Check my ETH balance"
Aura is thinking...
✓ Valid command: CHECK_BALANCE
Token: ETH
Balance: 2.847 ETH ($9,234.50)
aura chat "Send 0.1 ETH to 0x742d35Cc..."
Aura is thinking...
✓ Valid command: SEND_TOKEN
Token: ETH
Amount: 0.1
Target: 0x742d35Cc...

Supported Actions

Aura OS currently supports the following Web3 actions:

Action Description Example
CHECK_BALANCE Check token balance "Check my ETH"
SEND_TOKEN Transfer tokens "Send 0.5 ETH to 0x..."
SWAP_TOKEN Swap between tokens "Swap 100 USDC to ETH"
Supported tokens: ETH, SUI, USDT, USDC

Next Steps