<div align="center"> <h1><img src="images/logo.png" alt="ScienceClaw" width="36" style="vertical-align: middle;" /> ScienceClaw</h1>

English | 中文

</div>

ScienceClaw is a personal research assistant built with LangChain DeepAgents and AIO Sandbox infrastructure, adopting a completely new architecture beyond OpenClaw. It offers stronger security, better transparency, and a more user-friendly experience.

1,900+ built-in scientific tools · Multi-format content generation · Fully local & privacy-first

Why ScienceClaw · Architecture · News · Quick Start · Demo · Free API Credits · Tools & Skills · Features · Project Structure · Commands · Community · Acknowledgements

</div>

✨ Why ScienceClaw

🔒 Security First

ScienceClaw runs entirely inside Docker containers. The agent cannot access your host system, personal files, or environment variables. All code execution happens in an isolated sandbox, and generated data stays in a local ./workspace directory — nothing is uploaded to external servers. Deploy with confidence on your own machine.

</td> <td width="32%" valign="top">

👁️ Full Transparency

Every step of the agent's workflow is visible and traceable — from web search and data crawling, to reasoning and tool invocation, to final report generation. You always know where results come from, what actions were taken, and how conclusions were reached. Inspect any step at any time.

</td> <td width="31%" valign="top">

🚀 Ready Out of the Box

No tedious configuration needed. ScienceClaw ships with curated tools and skill packages — launch the entire environment with a single command. Whether you're a researcher, developer, or student, you can get started immediately. Focus on real tasks, not setup.

</td> </tr> </table>

🏗️ Architecture

📢 News

[2026-03-13] ScienceClaw v0.0.1 is officially released! Visit our website: scienceclaw.taichuai.cn

📦 Quick Start

Windows Users — Desktop App (One-Click Install)

No Docker required, no command-line needed. Download the desktop installer and get started instantly.

1. Download the installer

👉 ScienceClaw Desktop v0.0.4 (.tar.gz)

2. Extract and install

After downloading, extract the archive and run the installer. Follow the setup wizard to complete installation.

3. Launch

Once installed, double-click the desktop shortcut to start ScienceClaw — ready to use out of the box.

macOS / Linux Users — Docker Deployment

Prerequisites

Docker & Docker Compose (Docker Desktop includes Compose)
Recommended system RAM ≥ 8 GB

Install & Launch

1. Get the code

Fresh install:

git clone https://github.com/AgentTeam-TaichuAI/ScienceClaw.git
cd ScienceClaw

Upgrade an existing installation:

cd ScienceClaw
git pull

2. Launch — pull pre-built images

docker compose -f docker-compose-release.yml up -d --pull always

Pulls pre-built images directly — no local compilation needed. Ready in a few minutes.

3. Open in browser

http://localhost:5173

4. Login

<table> <tr> <td width="60%"> <img src="images/login.jpeg" alt="Login Page" width="100%" /> </td> <td width="40%" valign="middle" style="padding-left: 24px;"> <br/><br/> <p><strong>Default admin credentials:</strong></p> <table> <tr><td><strong>Field</strong></td><td><strong>Value</strong></td></tr> <tr><td>Username</td><td><code>admin</code></td></tr> <tr><td>Password</td><td><code>admin123</code></td></tr> </table> <blockquote>⚠️ Please change the default password after your first login.</blockquote> </td> </tr> </table>

🛠️ Developers — Build from Source

docker compose up -d --build

Builds all images from source code. Ideal for developers who need to modify the code. The first build downloads dependencies and may take longer.

🎬 Demo

🎁 Free LLM API Credits for Early Users

To lower the barrier for new users, a limited batch of LLM API resources:

| Offer | Details | |---|---| | SCNet (National Supercomputing Internet) | 10M free tokens (Claim here) | | Zidong Taichu Cloud | 10M free tokens (Claim here) |

Limited availability — first come, first served. We will continue to secure more compute resources for the community.

🔧 Tools & Skills System

🧪 1,900+ Built-in Scientific Tools

ScienceClaw integrates ToolUniverse, a unified ecosystem of 1,900+ scientific tools spanning multiple disciplines:

| Domain | Capabilities | |---|---| | 💊 Drug Discovery & Biomedicine | Target identification (OpenTargets), ADMET prediction, drug safety (FAERS), protein analysis (UniProt, PDB, AlphaFold), genomics (GWAS, GTEx), clinical trials | | 🔭 Astronomy & Space Science | SIMBAD astronomical objects, SDSS sky survey, NASA exoplanet archive, JPL Horizons ephemeris, NASA DONKI solar events, small body database | | 🌍 Earth & Environmental Science | USGS earthquakes & hydrology, ERDDAP ocean/climate data, SoilGrids, air quality (WAQI), OpenMeteo weather/climate, marine regions | | ⚗️ Chemistry & Materials | COD crystal structures, molecular property prediction, SMILES-based analysis, compound similarity, chemical computation | | 🌱 Biodiversity & Ecology | GBIF species records, OBIS marine biodiversity, POWO plant taxonomy, WoRMS marine species, eBird taxonomy, paleobiology database | | 📊 Social Science & Statistics | World Bank indicators, Eurostat, US Census population data, Wikidata knowledge graph, DBpedia | | 📚 Academic Literature | Multi-source search (PubMed, arXiv, OpenAlex, Semantic Scholar, DBLP, INSPIRE-HEP, Crossref, DOAJ, CORE) | | 🤖 Data Science & Computing | HuggingFace models/datasets, OpenML, GitHub repositories, scientific computing software, image processing |

🛠️ Four-Layer Tool Architecture

| Layer | Description | Examples | |---|---|---| | 🔧 Built-in Tools | Core search & crawl capabilities | web_search, web_crawl | | 🧪 ToolUniverse | 1,900+ scientific tools, ready to use | UniProt, OpenTargets, FAERS, PDB, ADMET, etc. | | 📦 Sandbox Tools | File operations & code execution | read_file, write_file, execute, shell | | 🛠️ Custom @tool | User-defined Python functions, hot-loaded from Tools/ | Your own tools |

🎨 Custom Tools

ScienceClaw makes it easy to extend with your own tools:

Natural language creation — Simply describe what you want in chat, and the agent will create, test, and save a new tool for you automatically.
Manual mounting — Drop any Python file with @tool decorated functions into the Tools/ directory; they are auto-detected and hot-loaded without restart.

🧠 Skill System

Skills are structured instruction documents (SKILL.md) that guide the Agent through complex, multi-step workflows. Unlike tools (executable code), skills act as the Agent's "playbook" — defining strategies, rules, and best practices.

Built-in Skills

| Skill | Purpose | |---|---| | 📄 pdf | Read, create, merge, split, OCR, and generate professional PDF research reports | | 📝 docx | Create and edit Word documents with cover pages, TOC, tables, and charts | | 📊 pptx | Generate and edit PowerPoint slide decks | | 📈 xlsx | Create and manipulate Excel spreadsheets, CSV/TSV data processing | | 🛠️ tool-creator | Create & upgrade custom @tool functions (write → test → save) | | 📝 skill-creator | Create & refine skills with draft → test → review → iterate | | 🔍 find-skills | Search, discover & install community skills from the open ecosystem | | 🧪 tooluniverse | Unified access to 1,900+ scientific tools |

Multi-Format Report Generation

ScienceClaw can produce professional research deliverables in 4 document formats:

| Format | Features | |---|---| | PDF | Cover page, table of contents, charts (bar/pie/line), in-text citations, references, academic styling | | DOCX | Cover page, TOC, tables, images, blue-superscript citations, Word-native formatting | | PPTX | Slide decks with titles, bullet points, images,

ScienceClaw

Install / Use

README