Skip to content

AgentTeam-TaichuAI/ScienceClaw

Repository files navigation

ScienceClaw ScienceClaw

English | 中文

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

Tools Skills Frontend Backend Scheduler Sandbox License


scienceclaw.mp4

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


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

👁️ 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.

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


🏗️ Architecture

Architecture

📢 News


📦 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

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

Login Page

Default admin credentials:

FieldValue
Usernameadmin
Passwordadmin123
⚠️ Please change the default password after your first login.

🛠️ 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

demo.mp4


🎁 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, speaker notes
XLSX Data tables, charts, multi-sheet workbooks, CSV/TSV export

Custom Skills

  • Natural language creation — Describe your workflow in chat, and the agent will draft, test, and save a new skill for you.
  • Manual installation — Place a folder with a SKILL.md file into the Skills/ directory. The agent automatically matches and loads relevant skills based on user intent.
  • Community ecosystem — Discover and install skills from the open community with the built-in find-skills capability.

💡 Practical Features

Feature Description
📨 One-Click Feishu (Lark) Integration Configure Feishu webhook notifications in settings — receive task results, alerts, and reports directly in your Feishu group chat.
Scheduled Tasks Set up recurring or one-time tasks with cron-like scheduling. The agent runs automatically at the specified time and delivers results via Feishu or in-app notifications.
📁 File Management System Built-in file panel for browsing, previewing, and downloading all workspace files generated during agent sessions — no need to dig through directories.
📊 Resource Monitoring Real-time system resource dashboard showing LLM resource consumption and service health — stay informed about your deployment status at a glance.

📂 Project Structure

ScienceClaw/
├── docker-compose.yml              # 10-service orchestration
├── docker-compose-release.yml      # Pre-built image orchestration (for end users)
├── docker-compose-china.yml        # China mirror acceleration
├── images/                         # Static assets (logo, screenshots)
├── videos/                         # Demo videos
├── Tools/                          # Custom tools (hot-reload)
├── Skills/                         # User & community skill packages
├── workspace/                      # 🔒 Local workspace (data never leaves your machine)
└── ScienceClaw/
    ├── backend/                    # FastAPI backend
    │   ├── deepagent/              # Core AI agent engine (LangGraph)
    │   ├── builtin_skills/         # 9 built-in skills (pdf, docx, pptx, xlsx, tooluniverse, ...)
    │   ├── route/                  # REST API routes
    │   ├── im/                     # IM integrations (Feishu / Lark)
    │   ├── mongodb/                # Database access layer
    │   ├── user/                   # User management
    │   ├── scripts/                # Utility scripts (Feishu setup, etc.)
    │   └── translations/           # i18n language packs
    ├── frontend/                   # Vue 3 + Tailwind frontend
    ├── sandbox/                    # Isolated code execution environment
    ├── task-service/               # Scheduled task service (cron jobs)
    └── websearch/                  # Search & crawl microservice

🧑‍💻 Useful Commands

# First launch (recommended for most users) — pull pre-built images, no local compilation
docker compose -f docker-compose-release.yaml up -d

# First launch (for developers) — build from source and start all services
docker compose up -d --build

# First launch (for developers in China) — build with Chinese mirror sources for faster downloads
docker compose -f docker-compose-china.yml up -d --build

# Daily launch — fast startup, no rebuild needed
docker compose up -d

# Check service status
docker compose ps

# View logs (-f to follow in real time)
docker compose logs -f backend     # Backend logs
docker compose logs -f frontend    # Frontend logs
docker compose logs -f sandbox     # Sandbox logs

# Restart a single service
docker compose restart backend

# Stop all services
docker compose down

# Stop a single service
docker compose stop backend

🗑️ Uninstall

ScienceClaw is built entirely on Docker, so uninstalling it is clean and simple — it has no side effects on your host system.

# Stop and remove all containers
docker compose down

# (Optional) Remove downloaded images to free up disk space
docker compose down --rmi all --volumes

Then simply delete the project folder:

rm -rf /path/to/ScienceClaw

That's it. No residual files, no registry entries, no system-level changes.


🏛️ Built By

Zhongke Zidong Taichu (Beijing) Technology Co., Ltd.


🤝 Community

We welcome contributions, feedback, and discussions! Join our community:

  • Submit issues and feature requests via GitHub Issues
  • Share your custom tools and skills with the community

📄 License

MIT License


🙏 Acknowledgements

ScienceClaw is built on the shoulders of excellent open-source projects. We would like to express our sincere gratitude to:

  • LangChain DeepAgents — The batteries-included agent harness built on LangChain and LangGraph. ScienceClaw's core agent engine is powered by the DeepAgents architecture, which provides planning, filesystem access, sub-agent delegation, and smart context management out of the box.

  • AIO Sandbox — The all-in-one agent sandbox environment that combines Browser, Shell, File, and MCP operations in a single Docker container. ScienceClaw relies on AIO Sandbox to provide secure, isolated code execution with a unified file system.

  • ToolUniverse — A unified ecosystem of 1,900+ scientific tools developed by the Zitnik Lab at Harvard. ToolUniverse powers ScienceClaw's multi-disciplinary research capabilities across drug discovery, genomics, astronomy, earth science, and more.

  • SearXNG — A privacy-respecting, hackable metasearch engine. ScienceClaw uses SearXNG as the backbone of its web_search tool, aggregating results from multiple search engines without tracking.

  • Crawl4AI — An open-source, LLM-friendly web crawler. ScienceClaw's web_crawl tool is powered by Crawl4AI, enabling intelligent content extraction from web pages for research and analysis.


⭐ Star History

Star History Chart

Contributors

Technical Support: NLP Group, Institute of Automation, Chinese Academy of Sciences

About

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.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors