Curaitor Agent

AI agent for scientific data extraction
Part of Schmidt OxRSE Workshop (Sep 11–20, 2025)

---

Overview

Curaitor Agent is an AI-powered tool designed to extract, organize, and process scientific data.
It provides:

• A web interface for running the agent.
• Model Context Protocol (MCP) inspector integration to test tools and server connections.

Documentation

https://curaitor-agent-docs.readthedocs.io/latest/

---

Quick Start

Install uv

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

Clone repo

git clone [email protected]:ritesh001/curaitor-agent.git
cd curaitor-agent

Initialize project

uv sync

Edit config file

choose the model you want to use under llm:

• provider: openai
• model: "gpt-5-mini"

Provide gmail address

• send your gmail email address to [email protected] to be added to the user pool

add .env file

Create .env file in the agent folder with your

OPENAI_API_KEY=
OPENROUTER_API_KEY=
GMAIL_CREDENTIALS_PATH=
GMAIL_TOKEN_PATH=secrets/token.json

Run gmail authentication

This will work for 1 hour.

uv run python curaitor_agent_v2/gmail_create_token.py

Run web interface

uv run adk web

Run LangGraph pipeline (no Google SDK)

This runs the literature RAG workflow orchestrated by LangGraph using your config and API keys.

uv run python -m curaitor_agent.langraph_pipeline --query "your research question"

Scheduling (LangGraph)

Automate the pipeline via cron or macOS launchd.

Cron (daily 07:00)

• Edit crontab:
  • crontab -e
• Add lines (update absolute paths):
  • SHELL=/bin/zsh
  • PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin
  • 0 7 * * * cd /absolute/path/to/curaitor-agent && /opt/homebrew/bin/uv run python scripts/run_daily.py --query "plastic recycling" --max-days 7 --db data/curaitor.sqlite >> logs/langraph_daily.log 2>&1

launchd (macOS)

• Copy scripts/launchd/curaitor.langraph.sample.plist to ~/Library/LaunchAgents/com.curaitor.langgraph.daily.plist
• Edit the plist and replace all /absolute/path/to/curaitor-agent with your repo path
• Ensure log directory exists: mkdir -p /absolute/path/to/curaitor-agent/logs
• Load:
  • launchctl load ~/Library/LaunchAgents/com.curaitor.langgraph.daily.plist
  • launchctl start com.curaitor.langgraph.daily

The CLI wrapper scripts/run_daily.py runs the pipeline and upserts results into data/curaitor.sqlite by default.

Functions you can use

curaitor_agent

• create database
• query database

curaitor_agent_v2

• search and summarize paper from arxiv
• schedule time of day for daily search
• send email summary to yourself
  • send email to [email protected] to be added to the user pool

---

For Developer

Dependency Management

• Sync when requirements.txt is updated:

  uv sync

• Add a new package:

  uv add package-name

  (Don’t forget to update requirements.txt!)

---

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

1. Install nvm:

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   \. "$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.

---

Notes

• 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.