Installation

Package Installation

# npm (recommended)
npm install -g @agentic-work/agenticode

# yarn
yarn global add @agentic-work/agenticode

# pnpm
pnpm add -g @agentic-work/agenticode

Requirements

• Node.js: 20 or higher

• LLM Provider: Ollama (local) or AgenticWork API key

Provider Setup

Option 1: Ollama (Local, Free)

Install Ollama from ollama.ai, then pull a model:

# Install a model
ollama pull llama3.2
# or
ollama pull qwen2.5-coder

# Start Ollama (usually runs automatically)
ollama serve

AgentiCode will auto-detect Ollama at http://localhost:11434.

Option 2: AgenticWork API

Get an API key from the AgenticWork platform and set it:

export AGENTICWORK_API_KEY=your-api-key
export AGENTICWORK_API_ENDPOINT=https://api.agenticwork.io

Verification

# Check installation
agenticode --version

# Run interactive session
agenticode

The setup wizard will guide you through:

1. Detecting available providers

2. Selecting an Ollama host (if using local)

3. Choosing a model

Updating

npm update -g @agentic-work/agenticode

Troubleshooting

Command not found

Ensure npm global bin is in your PATH:

# Check npm bin location
npm config get prefix

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$(npm config get prefix)/bin:$PATH"

Ollama not detected

1. Ensure Ollama is running: ollama serve

2. Check the default URL: curl http://localhost:11434/api/tags

3. Specify a custom URL: agenticode -o http://your-host:11434

API authentication failed

1. Verify your API key is set correctly

2. Check the endpoint URL

3. Ensure your key has not expired