Installation

This page provides detailed instructions for installing and setting up Curaitor Agent. The installation process is divided into two main parts:

  1. Installing Curaitor Agent and its dependencies.

  2. Setting up the MCP Inspector Tool (optional but recommended).

Prerequisites

Before you begin, ensure you have the following:

  • A Unix-based environment (Linux or macOS recommended).

  • Internet access to download dependencies.

  • Basic familiarity with the command line.

Installing Curaitor Agent

The project uses uv, a modern Python package and environment manager.

  1. Install uv:

    curl -LsSf https://astral.sh/uv/install.sh | sh

  2. Clone the repository:

    git clone <your-repo-url>
cd curaitor-agent

  3. Initialize the project:

    uv init
uv add -r requirements.txt

  4. Run the web interface:

    uv run adk web

Dependency Management

Curaitor Agent relies on reproducible environments. You should keep your dependencies synchronized at all times.

  • Sync when ``requirements.txt`` is updated:

    uv sync

  • Add a new package:

    uv add package-name

    Note

    Don’t forget to update requirements.txt after adding or removing a dependency.

MCP Inspector Tool

The Model Context Protocol (MCP) Inspector is an optional utility that helps verify your MCP server connection and test available tools.

Requirements

  • nvm (Node Version Manager)

  • Node.js ≥ 18 (v22 recommended)

Setup

  1. Install nvm:

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | \
. "$HOME/.nvm/nvm.sh"

  2. Install Node.js v22:

    nvm install 22

  3. Verify versions:

    node -v   # v22.19.0
npm -v    # 10.9.3

  4. Run the MCP Inspector:

    npx @modelcontextprotocol/inspector uv run tools/mcp_server.py

  5. In the MCP Inspector UI, click Connect → test tools.

Important

  • Always use Node.js v22.x when running the MCP Inspector.

  • Keep your environment synchronized with requirements.txt to ensure reproducibility.

Troubleshooting

  • If uv is not found after installation, make sure ~/.local/bin is in your PATH.

  • When upgrading Node.js versions, run nvm use 22 to ensure compatibility.

  • If dependencies fail to install, try cleaning the environment with:

    uv clean
uv sync

Next Steps

Once installation is complete, you can proceed to: