Installation
Set up Aura OS on your machine in under 2 minutes.
System Requirements
Before installing Aura OS, ensure your system meets these requirements:
Node.js
v18.0 or higher
Required runtime for executing Aura OS
npm or pnpm
Latest version
Package manager for installation
OpenAI API Key
For AI features
Powers the natural language interpreter
EVM Wallet
Private key access
For executing blockchain transactions
Install via npm
Option 1: Global Installation (Recommended)
Install Aura OS globally to use it from anywhere:
Option 2: Using pnpm
Option 3: Run without installing
Use npx to try Aura OS without global installation:
Environment Setup
Create a .env file
in your home directory or project root:
AI Provider Fallback
Aura OS automatically falls back to Groq and Gemini if OpenAI fails or hits rate limits. Configure multiple providers for maximum reliability.
Verify Installation
Test that everything is working correctly:
Troubleshooting
Command not found: aura
This usually means npm's global bin directory isn't in your PATH.
OpenAI API Error
Ensure your OPENAI_API_KEY is valid and has sufficient credits.
Aura will automatically fallback to Groq or Gemini if configured.
Permission Denied
On macOS/Linux, you may need to use sudo npm install -g @felizz23/aura-os
or configure npm to use a different global directory.