NeuAI Installation Wizard

Welcome to NeuAI

Let's get you set up with your personal AI assistant. This wizard will guide you through the installation process.

✨

What is NeuAI?

A zero-dependency AI assistant CLI powered by Azure OpenAI with persistent memory across sessions.

✓

Python 3.7+
Required to run NeuAI. No additional packages needed!
Azure OpenAI Access
You'll need an Azure OpenAI resource with a deployed model.
Terminal Access
Access to a command line (Terminal, PowerShell, etc.)

💡

Don't have Azure OpenAI yet?

Apply for access at azure.microsoft.com

Azure OpenAI Credentials

Enter your Azure OpenAI credentials. These will be stored locally and never leave your machine.

Endpoint URL *

Found in Azure Portal → Your OpenAI Resource → Keys and Endpoint

Please enter a valid endpoint URL

API Key *

Found in Azure Portal → Your OpenAI Resource → Keys and Endpoint → Key 1 or Key 2

API key is required

Deployment Name *

The name of your deployed model (e.g., gpt-4, gpt-35-turbo)

API Version

Installation Commands

Run these commands in your terminal to install NeuAI.

Step 1: Create directory & download files

mkdir -p ~/.neuai
curl -o ~/.neuai/neuai-cli.py https://raw.githubusercontent.com/kody-w/localFirstTools/revert/neuai-cli.py
curl -o ~/.neuai/neuai-agent-bridge.py https://raw.githubusercontent.com/kody-w/localFirstTools/revert/neuai-agent-bridge.py
chmod +x ~/.neuai/neuai-cli.py

Step 2: Create config file

Step 3: Set secure permissions

chmod 600 ~/.neuai/config.json

Step 1: Create directory (PowerShell)

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.neuai"

Step 2: Download files

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/kody-w/localFirstTools/revert/neuai-cli.py" -OutFile "$env:USERPROFILE\.neuai\neuai-cli.py"
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/kody-w/localFirstTools/revert/neuai-agent-bridge.py" -OutFile "$env:USERPROFILE\.neuai\neuai-agent-bridge.py"

Step 3: Create config file

💾 Or Download Install Script

Download a ready-to-run script with your configuration embedded

Verify Installation

Let's make sure everything is working correctly.

Test your connection

python3 ~/.neuai/neuai-agent-bridge.py test

You should see output like:

{ "success": true, "command": "test", "connection_status": "ok", "message": "Connection successful", "endpoint": "https://your-resource...", "deployment": "gpt-4" }

🔧

Getting an error?

Double-check your credentials in Step 2, or run python3 ~/.neuai/neuai-cli.py --configure to reconfigure.

🎉

You're All Set!

NeuAI is installed and ready to use.

Start NeuAI

python3 ~/.neuai/neuai-cli.py

Or use the Agent Bridge for automation

python3 ~/.neuai/neuai-agent-bridge.py chat "Hello, NeuAI!"

📚

Learn More

Check out the full tutorial to learn about memory, subjects, and automation.

View Documentation