Aura CLI: Ultimate AI Agent

Aura is an advanced, autonomous AI Agent CLI capable of executing and managing tasks in multiple programming languages (Python, PowerShell, Java, C++, JavaScript, TypeScript, PHP, Ruby, C#, CMD). It automatically analyzes your tasks, writes code solutions, and executes them in the safest way possible.

Prerequisites

Before setting up and running Aura, ensure you have the following installed on your system:

1. Node.js (v18.0.0 or higher) - Download Node.js
2. Python 3 (v3.8 or higher) - Download Python
   • Note: On Windows, make sure to check the option "Add Python to PATH" during installation.

Quick Setup (Windows)

For a fully automated installation on Windows, simply double-click and run:

• setup.bat

This setup assistant will:

1. Validate Node.js, npm, and Python installations.
2. Install local Node.js dependencies.
3. Register the aura command globally.
4. Install Python dependencies from requirements.txt.
5. Verify and configure your system PATH so aura is immediately recognized as a command.

Note: After running setup.bat, close any active terminal windows and open a new one to apply the environment path changes.

Manual Setup (All OS)

If you prefer to install dependencies and link the CLI tool manually, run the following commands in the project directory:

# 1. Install Node.js dependencies
npm install

# 2. Register the 'aura' command globally
npm install -g .

# 3. Install Python dependencies
pip install -r requirements.txt

How to Use

Once installed, open a new command prompt or shell window and type:

aura

This starts Aura in interactive chat mode. Describe any task, and Aura will write and execute the optimal code solution:

Task: list all .json files in the current folder

Commands in Interactive Mode

• exit or quit: Terminate the Aura CLI session.
• reset: Reset conversation history.
• /provider <ollama|puter>: Change the AI provider (Default is puter).
• /model <provider> change <model>: Change the LLM model used for the specified provider.

Single-Command Mode

You can also run Aura for a single, one-off task directly from your command line:

aura "create a file called test.txt with Hello World in it"

Troubleshooting

1. 'aura' is not recognized as an internal or external command

This happens when your NPM global directory is not in your system's PATH environment variable.

• On Windows: Check if %APPDATA%\npm is in your environment variables. The setup.bat script can automatically add this for you.
• Make sure to restart your terminal window after linking/running setup.

2. Typing 'aura' echoes back empty or launches the Microsoft Store

This occurs on Windows systems when Python is not installed from python.org, but the Windows App Execution Aliases are active.

• Aura now automatically filters out these dummy stubs.
• If you face issues, search for "Manage app execution aliases" in the Windows Start menu, locate python.exe / python3.exe, and toggle them Off.
• Ensure a real Python 3 installation is present and added to your PATH.