EvoScientist 0.0.1.dev2__py3-none-any.whl → 0.0.1.dev4__py3-none-any.whl

{evoscientist-0.0.1.dev2.dist-info → evoscientist-0.0.1.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: EvoScientist
-Version: 0.0.1.dev2
+Version: 0.0.1.dev4
 Summary: EvoScientist: Towards Self-Evolving AI Scientists for End-to-End Scientific Discovery
 Author: Xi Zhang
 Maintainer: Xi Zhang
@@ -16,11 +16,14 @@ License-File: LICENSE
 Requires-Dist: deepagents>=0.3.6
 Requires-Dist: langchain>=1.2
 Requires-Dist: langchain-anthropic>=1.3
-Requires-Dist: anthropic>=0.76
+Requires-Dist: langchain-openai>=0.3
+Requires-Dist: langchain-nvidia-ai-endpoints>=0.3
 Requires-Dist: tavily-python>=0.7
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=14.0
 Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: questionary>=2.0.1
+Requires-Dist: typer>=0.12
 Requires-Dist: python-dotenv>=1.0
 Requires-Dist: langgraph-cli[inmem]>=0.4
 Requires-Dist: httpx>=0.27
@@ -28,6 +31,8 @@ Requires-Dist: markdownify>=0.14
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
 Dynamic: license-file
 
 <!-- Add logo here -->
@@ -60,7 +65,9 @@ Dynamic: license-file
 
 
 ## 📖 Contents
+- [🤖 Supported Models](#-supported-models)
 - [⛏️ Installation](#️-installation)
+- [🔑 API Key Configuration](#-api-key-configuration)
 - [⚡ Quick Start](#-quick-start)
   - [CLI Inference](#cli-inference)
   - [Script Inference](#script-inference)
@@ -71,6 +78,24 @@ Dynamic: license-file
 - [📦 Codebase Contributors](#-codebase-contributors)
 - [📜 License](#-license)
 
+## 🤖 Supported Models
+
+| Provider | Short Name | Model ID |
+|----------|-----------|----------|
+| Anthropic | `claude-sonnet-4-5` | `claude-sonnet-4-5-20250929` |
+| Anthropic | `claude-opus-4-5` | `claude-opus-4-5-20251101` |
+| Anthropic | `claude-3-5-sonnet` | `claude-3-5-sonnet-20241022` |
+| Anthropic | `claude-3-5-haiku` | `claude-3-5-haiku-20241022` |
+| OpenAI | `gpt-4o` | `gpt-4o` |
+| OpenAI | `gpt-4o-mini` | `gpt-4o-mini` |
+| OpenAI | `o1` | `o1` |
+| OpenAI | `o1-mini` | `o1-mini` |
+| NVIDIA | `glm4.7` | `z-ai/glm4.7` |
+| NVIDIA | `deepseek-v3.1` | `deepseek-ai/deepseek-v3.1-terminus` |
+| NVIDIA | `nemotron-nano` | `nvidia/nemotron-3-nano-30b-a3b` |
+
+You can also use any full model ID directly — the provider will be inferred automatically.
+
 ## ⛏️ Installation
 
 > [!TIP]  
@@ -106,6 +131,56 @@ uv pip install -e .
 
 </details>
 
+## 🔑 API Key Configuration
+
+EvoScientist requires API keys for LLM inference and web search. You can configure them in three ways:
+
+### Option A: Interactive Setup Wizard (Recommended)
+
+```Shell
+EvoSci onboard
+```
+
+The wizard guides you through selecting a provider, entering API keys, choosing a model, and configuring workspace settings. Keys are validated automatically.
+
+### Option B: Environment Variables (Global)
+
+Set keys directly in your terminal session. Add these to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.) to persist across sessions:
+
+```Shell
+export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
+export TAVILY_API_KEY="your_tavily_api_key_here"
+
+# Optional: OpenAI or NVIDIA provider
+export OPENAI_API_KEY="your_openai_api_key_here"
+export NVIDIA_API_KEY="your_nvidia_api_key_here"
+```
+
+### Option C: `.env` File (Project-level)
+
+Create a `.env` file in the project root. This keeps keys scoped to the project and out of your shell history:
+
+```Shell
+cp .env.example .env
+```
+
+Then edit `.env` and fill in your keys:
+
+```
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+TAVILY_API_KEY=your_tavily_api_key_here
+```
+
+> [!WARNING]
+> Never commit `.env` files containing real API keys to version control. The `.env` file is already included in `.gitignore`.
+
+| Key | Required | Description |
+|-----|----------|-------------|
+| `ANTHROPIC_API_KEY` | For Anthropic | Anthropic API key for Claude ([console.anthropic.com](https://console.anthropic.com/)) |
+| `OPENAI_API_KEY` | For OpenAI | OpenAI API key for GPT models ([platform.openai.com](https://platform.openai.com/)) |
+| `NVIDIA_API_KEY` | For NVIDIA | NVIDIA API key for NIM models ([build.nvidia.com](https://build.nvidia.com/)) |
+| `TAVILY_API_KEY` | Yes | Tavily API key for web search ([app.tavily.com](https://app.tavily.com/)) |
+
 ## ⚡ Quick Start
 
 ### CLI Inference  
@@ -120,9 +195,74 @@ or
 ```Shell
 EvoSci # or EvoScientist
 ```
-**Optional arguments:**  
+**Optional arguments:**
 
-> TODO
+```
+--mode <mode>      Workspace mode: 'daemon' (persistent) or 'run' (isolated per-session)
+--workdir <path>   Override workspace directory for this session
+--use-cwd          Use current working directory as workspace
+--thread-id <id>   Resume a conversation thread
+--no-thinking      Disable thinking display
+-p, --prompt <q>   Single-shot mode: execute query and exit
+```
+
+**Configuration commands:**
+
+```Shell
+EvoSci onboard                # Interactive setup wizard
+EvoSci onboard --skip-validation  # Skip API key validation
+EvoSci config                 # List all configuration values
+EvoSci config get <key>       # Get a single value
+EvoSci config set <key> <val> # Set a single value
+EvoSci config reset --yes     # Reset to defaults
+EvoSci config path            # Show config file path
+```
+
+**Interactive Commands:**
+
+| Command | Description |
+|---------|-------------|
+| `/exit` | Quit the session |
+| `/new` | Start a new session (new workspace + thread) |
+| `/thread` | Show current thread ID and workspace path |
+| `/skills` | List installed user skills |
+| `/install-skill <source>` | Install a skill from local path or GitHub |
+| `/uninstall-skill <name>` | Uninstall a user-installed skill |
+
+**Skill Installation Examples:**
+
+```bash
+# Install from local path
+/install-skill ./my-skill
+
+# Install from GitHub URL
+/install-skill https://github.com/owner/repo/tree/main/skill-name
+
+# Install from GitHub shorthand
+/install-skill owner/repo@skill-name
+```
+
+### Runtime Directories
+
+By default, the **workspace** is created under the current directory:
+
+```
+./workspace/
+  memory/   # shared MEMORY.md (persistent across sessions)
+  skills/   # user-installed skills
+  runs/     # per-session workspaces
+```
+
+You can force workspace to be the current directory via `--use-cwd`.
+
+Override individual paths via environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `EVOSCIENTIST_WORKSPACE_DIR` | `./workspace` | Root workspace directory |
+| `EVOSCIENTIST_RUNS_DIR` | `./workspace/runs` | Per-session run directories |
+| `EVOSCIENTIST_MEMORY_DIR` | `./workspace/memory` | Shared memory storage |
+| `EVOSCIENTIST_SKILLS_DIR` | `./workspace/skills` | User-installed skills |
 
 ### Script Inference
 ```python

{evoscientist-0.0.1.dev2.dist-info → evoscientist-0.0.1.dev4.dist-info}/RECORD

@@ -1,13 +1,20 @@
-EvoScientist/EvoScientist.py,sha256=k7iMQUDR6AB37k8z6n84hRQunLbWAwr43e8VJhG-hpI,4806
-EvoScientist/__init__.py,sha256=yj4YJUPldtq4xx8geadIoZ1n-BmgsM2Z_S2W8ld9S1k,702
+EvoScientist/EvoScientist.py,sha256=qhiCOOZvH6cmjLiKRMvfr74xJM7x-dZrrRoX9xrfLtQ,6053
+EvoScientist/__init__.py,sha256=BN8yi3iCIaq2gNfKORrI9OvMq49a2LrYWgEqW86vYLw,1120
 EvoScientist/__main__.py,sha256=P5USQ_BiiY0TBhtajGMuX5AMXlQ5joz1kvljHeacqmA,91
 EvoScientist/backends.py,sha256=3fIYRdOecL-KZx2hSNolsLO-2_rMzey-NpVMDMN701U,13355
-EvoScientist/cli.py,sha256=-7iL6NUjW5CmLKx1BLd0d-Y2DtcXPcoMOCdOgA6X-_E,59946
-EvoScientist/middleware.py,sha256=xHpqmru32osSBeQ43ZCn-8obgnheWekaTgE3TGa_1nQ,1044
+EvoScientist/cli.py,sha256=5y_yTBhLnXxI5JVFawcYbsbDEWMED_t2-X4LVbT24kY,25978
+EvoScientist/config.py,sha256=rXD_qlrTxP3HLH7H6DxvqKP4WwymyrzRyS8665igd6k,8649
+EvoScientist/memory.py,sha256=ZgITkiLezjAeo9z12UWRZurE1hZU7ehF-SAKrchPIEs,26475
+EvoScientist/middleware.py,sha256=hBHov8wFhe-AS-C84BFRDgikl5q8Xb9AMU4FfNxs9Jg,2620
+EvoScientist/onboard.py,sha256=x6THI4ryTMTBQBb90JRFhcZmPsc970yh77_VCuNqwm8,22200
+EvoScientist/paths.py,sha256=r3u632RJXfl8KPVhWBwVKPx9zFbvj1CZCIf7NeFBja4,1346
 EvoScientist/prompts.py,sha256=ni-qHoEoM703xtfD4J3IlvwAWPcW8gcNiCBVjRJoy3g,10692
+EvoScientist/skills_manager.py,sha256=r1ZCnZkFij-uRwj09FmT67VFR5eRgd3ynzKWmykQJeI,12205
 EvoScientist/subagent.yaml,sha256=yoFlMJWitLlYuOe4_44EPG6vjpNP_txHBlqr-kNX2GM,6130
-EvoScientist/tools.py,sha256=oYaJN8tl_NCw6PLFFNRZbjPB9-VriVcpVb6Zp-d_xVQ,4223
+EvoScientist/tools.py,sha256=7rCq3Sy74qAKEKnttvy9H7-LB8moXeYK0h7xRJnZJGk,6772
 EvoScientist/utils.py,sha256=GuWMRMkPHYgUOtoPZA0ErIt4FUBE4NMkz_OZluxYyRo,6801
+EvoScientist/llm/__init__.py,sha256=A3nQPKGP6qqh2K72_NZlUozNNwfD4jcEMyBerne9IGc,363
+EvoScientist/llm/models.py,sha256=3AhHG__OLbnQlgB3kIM3Ejf9kU2Cv6rDzc7uT5eKzYk,3335
 EvoScientist/skills/accelerate/SKILL.md,sha256=Ju_xLlGW3bZBWQO_8FWThkP155jE2atq9Ww0Zn8XwEs,8328
 EvoScientist/skills/accelerate/references/custom-plugins.md,sha256=Gy8c9dcKFV93ksrRKkZr5DFbeH_iHgGzbTK_N0aTwCA,11781
 EvoScientist/skills/accelerate/references/megatron-integration.md,sha256=ad7cw8eMGX3vqGUxQSVBuWpiQJDAr9eHqWfPhlEXJz0,11252
@@ -94,14 +101,17 @@ EvoScientist/skills/skill-creator/references/workflows.md,sha256=70hGh31dq0dRGgG
 EvoScientist/skills/skill-creator/scripts/init_skill.py,sha256=C7olC5TKpMsrKLFdrSb9zzca7aTJeXuBIOVcLjPgxzw,10863
 EvoScientist/skills/skill-creator/scripts/package_skill.py,sha256=sx-8s-Ni1cUwjpklX_joPN46UT4GNpU5ZKZISUyhCTE,3288
 EvoScientist/skills/skill-creator/scripts/quick_validate.py,sha256=OBqy09H9XsMjcQFkEwY-_5nQ1IxBV0cIXGFRfpZ9u4c,3523
-EvoScientist/stream/__init__.py,sha256=cO30Ujs7mVB1pZjI0AXgaggmPeV6jXgBjt6AKYH42kQ,1219
+EvoScientist/stream/__init__.py,sha256=_mdc88i75D3qlfuIBWpNm4-W5xMYIvM39vERgb53Bkk,1933
+EvoScientist/stream/display.py,sha256=jCyohjfulwgyV-gOa5g5HXsepNLNLjdMdfQE9bt1-ZA,22565
 EvoScientist/stream/emitter.py,sha256=zmdn8vIXNgkgoWRtanrMtPN2GlsHmZtdFmoqCry3o_o,2978
+EvoScientist/stream/events.py,sha256=dSnHsDGl_HEBbfmQYv40YZVR-RDZPLZFsjlwmO46ch4,17251
 EvoScientist/stream/formatter.py,sha256=vyv89NGoTzxjsWt0teBXX38MZzFLhzMDBUcIH6-slDo,5532
+EvoScientist/stream/state.py,sha256=RX7JOBJLYXu7tdtDx71QR2U8JDHHTsB4GM877z9UKLM,12961
 EvoScientist/stream/tracker.py,sha256=cVWmiTCiwzOh84I7sAXXfgr_HXxOCCCzTvli-XJhthQ,3670
-EvoScientist/stream/utils.py,sha256=36e5aaEZVpwTZnqO1qlVs2QTr04JbmWuvHMSbor49xM,7278
-evoscientist-0.0.1.dev2.dist-info/licenses/LICENSE,sha256=NsYFy5JSm90lmXcPNQuthVTCVaVcbT4XZ9h5HpAoGIo,1069
-evoscientist-0.0.1.dev2.dist-info/METADATA,sha256=kAPIhFnqM-VoqTJUDDDHOdGoRjA-vDY4lh_W52EkFJE,8797
-evoscientist-0.0.1.dev2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-evoscientist-0.0.1.dev2.dist-info/entry_points.txt,sha256=mGxz9_-jfGhwkdiiVGTQ9IQEhzLixWJoPNU39_boWMM,154
-evoscientist-0.0.1.dev2.dist-info/top_level.txt,sha256=XBZouSd9lQfNn0Fus6jQb9nqdXzAbKyzh987Jt3A2-A,13
-evoscientist-0.0.1.dev2.dist-info/RECORD,,
+EvoScientist/stream/utils.py,sha256=yQXhPIzOYzpNUUyDvkQDv1K-Yo0ePkXMtU7fHhRoG64,7718
+evoscientist-0.0.1.dev4.dist-info/licenses/LICENSE,sha256=NsYFy5JSm90lmXcPNQuthVTCVaVcbT4XZ9h5HpAoGIo,1069
+evoscientist-0.0.1.dev4.dist-info/METADATA,sha256=Hi6nET3VH8m2uv_JIcCNrQZJz4jL1OfbMd6jM5tGEY0,13901
+evoscientist-0.0.1.dev4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+evoscientist-0.0.1.dev4.dist-info/entry_points.txt,sha256=mGxz9_-jfGhwkdiiVGTQ9IQEhzLixWJoPNU39_boWMM,154
+evoscientist-0.0.1.dev4.dist-info/top_level.txt,sha256=XBZouSd9lQfNn0Fus6jQb9nqdXzAbKyzh987Jt3A2-A,13
+evoscientist-0.0.1.dev4.dist-info/RECORD,,