README.md

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

# SciEvo

```shell
# 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.:

```shell
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:

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

## Development Guide

First, install `pre-commit`:
```shell
pip install pre-commit
```

Install `pre-commit` to format code:
```shell
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.