Skip to content

Installation

Get Nova AI up and running in minutes.

Prerequisites

Quick Install

# Clone repository
git clone https://github.com/Jaureguy760/nova_ai.git
cd nova_ai

# Set API key
export ANTHROPIC_API_KEY="your-key-here"

# Use slash commands in Claude Code
/novaai your task here

# Clone repository
git clone https://github.com/Jaureguy760/nova_ai.git
cd nova_ai

# Install with dev dependencies
pip install -e ".[dev]"

# Set up environment
cp .env.example .env
# Edit .env with your API keys

# Verify installation
pytest tests/ -v
ruff check src/ tests/

# Install from source
pip install git+https://github.com/Jaureguy760/nova_ai.git

# Set API key
export ANTHROPIC_API_KEY="your-key-here"

# Use in Python
from src.orchestrator.claude_sdk_executor import ClaudeSDKExecutor

Configuration

Required: API Key

# Option 1: Environment variable
export ANTHROPIC_API_KEY="sk-ant-..."

# Option 2: .env file (recommended for development)
echo "ANTHROPIC_API_KEY=sk-ant-..." > .env

Optional: LangFuse (Cost Tracking)

# Add to .env for cost tracking and analytics
LANGFUSE_PUBLIC_KEY="pk-lf-..."
LANGFUSE_SECRET_KEY="sk-lf-..."
LANGFUSE_HOST="https://cloud.langfuse.com"

Optional: GitHub Integration

# Add to .env for GitHub MCP server
GITHUB_TOKEN="ghp_..."
GITHUB_REPO="owner/repo"

See Environment Setup for complete configuration options.

Verification

Test Slash Commands

In Claude Code:

/novaai help

Expected output: Nova AI orchestrator help message

Test Python SDK

from src.orchestrator.claude_sdk_executor import ClaudeSDKExecutor
from pathlib import Path

executor = ClaudeSDKExecutor(
    project_root=Path.cwd(),
    agent_name="orchestrator",
    use_sdk_mcp=True
)

result = await executor.run_task("What agents are available?")
print(result.transcript)

Run Tests

pytest tests/ -v

All tests should pass.

Troubleshooting

Import Errors

# Ensure you're in the project root
cd /path/to/nova_ai

# Reinstall
pip install -e ".[dev]"

API Key Issues

# Verify API key is set
echo $ANTHROPIC_API_KEY

# Should print: sk-ant-...

MCP Server Issues

# Check MCP servers are available
python -c "from src.orchestrator.tools.sdk_mcp_kb_server import search_knowledge_base; print('OK')"

Next Steps