Quickstart

Quick Start

To get started with Curaitor Agent, follow these steps:

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

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

# Initialize project
uv init
uv add -r requirements.txt

# Run web interface
uv run adk web

Dependency Management

Keep your environment consistent and reproducible with these commands:

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 a new dependency!

MCP Inspector Tool

The MCP Inspector helps verify your MCP server connection and test available tools.

Requirements

nvm (Node Version Manager)
Node.js ≥ 18 (v22 recommended)

Setup

Install nvm:

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

Install Node.js v22:
```
nvm install 22
```

Verify versions:

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

Run the MCP Inspector:

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

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

Important

Ensure you’re using Node.js v22.x when running the inspector.
Always keep your environment in sync with requirements.txt for reproducibility.

License

This project is licensed under the MIT License.