Installation

AI-First can be installed in several ways depending on your needs.

Global Installation (Recommended)

npm install -g ai-first

Then run:

ai-first --help

Without Installation (npx)

# Initialize
npx ai-first init

# Index
npx ai-first index

# Doctor check
npx ai-first doctor

Development Mode

# Clone the repository
git clone https://github.com/julianperezpesce/ai-first.git
cd ai-first

# Install dependencies
npm install

# Build
npm run build

# Link for local testing
npm link

# Run
ai-first --help

Requirements

• Node.js 18+
• npm 8+ (comes with Node.js)

Optional Dependencies

For semantic search with embeddings:

npm install @xenova/transformers

Update AI-First

# If installed globally
npm update -g ai-first

# Check version
ai-first --version

Uninstall

npm uninstall -g ai-first

Troubleshooting

Permission Errors

If you get permission errors on macOS/Linux:

sudo npm install -g ai-first

Or use a version manager like nvm.

Path Issues

Make sure npm global bin is in your PATH:

# Add to ~/.bashrc or ~/.zshrc
export PATH="$(npm root -g)/bin:$PATH"