README.md

metadata

title: SciEvo
emoji: 🚀
colorFrom: indigo
colorTo: purple
sdk: docker
pinned: false

SciEvo

# for cpu
uv sync --extra cpu

# for mac
uv sync --extra mac

# for gpu
uv sync --extra cu128

Optional: install Claude Code (for claude_code toolset):

• Ensure the claude CLI is installed and authenticated on your machine.
• If your claude command needs extra flags, set CLAUDE_CODE_CMD, e.g.:

export CLAUDE_CODE_CMD="claude"

Optional: install Claude Agent SDK (for claude_agent_sdk toolset):

• Docs: https://platform.claude.com/docs/en/agent-sdk/overview
• Install:

pip install claude-agent-sdk
export ANTHROPIC_API_KEY="..."

Development Guide

First, install pre-commit:

pip install pre-commit

Install pre-commit to format code:

pre-commit install

Then, copy .env.template to .env and fill in the necessary values.

OPENAI_API_KEY=<your_openai_api_key>
GEMINI_API_KEY=<your_gemini_api_key>
ANTHROPIC_API_KEY=<your_anthropic_api_key>  # Required for Claude Agent SDK (coding agent v3)

Hugging Face Spaces Configuration

For Hugging Face Spaces deployment, set the following Secrets in your Space settings:

• OPENAI_API_KEY - OpenAI API key
• GEMINI_API_KEY - Google Gemini API key
• ANTHROPIC_API_KEY - Anthropic API key (required for Claude Agent SDK)

Important: Do NOT commit .env file with real API keys to the repository. Use Hugging Face Spaces Secrets instead.