🧪 AI-Sci: Autonomous Scientific Research Agent
One command from research question to LaTeX paper. Built on DeepAgents + LangGraph, incorporating the ARIS research methodology.
Install
uv tool install ai-sci-agent
ai-sci setup # interactive wizard — pick provider, enter key
ai-sci run "improve LoRA with adaptive rank" --paper paper.pdf --repo ~/code
Or with pip:
pip install ai-sci
ai-sci setup
9-Phase Research Pipeline
search → analyze → refine → experiment_plan → reproduce → implement → experiment → review → write
| Phase | What it does |
|---|---|
| search | Multi-source literature search with 3-layer anti-hallucination verification |
| analyze | PICO-M deep reading, 4-axis critical scoring, cross-paper synthesis |
| refine | Problem Anchor freeze, 7-dim iterative method scoring |
| experiment_plan | Claim-driven experiment design with 5-block evidence storyline |
| reproduce | Clone repos, install deps, run baselines, compare with paper claims |
| implement | Map method proposal to code changes, edit codebase, verify |
| experiment | Code integrity audit → sanity check → execute → stats → iterate |
| review | Structured peer review with weakness grading |
| write | LaTeX paper + 5-pass sciwrite audit + verified citations |
Usage
# Full pipeline
ai-sci run "research question" \
--paper https://arxiv.org/abs/2106.09685 \
--repo ~/code \
--data ~/datasets
# Interactive mode
ai-sci run "explore and improve this codebase" \
--repo ~/code --interactive
# List/resume sessions
ai-sci sessions
ai-sci run "..." --resume sci-20260623-094430
# Single-phase commands
ai-sci search "query"
ai-sci analyze "Paper Title"
Configuration
Run ai-sci setup for interactive setup, or create ~/.ai_sci/.env:
MODEL_NAME=deepseek-chat
API_KEY=sk-your-key
BASE_URL=https://api.deepseek.com/v1
TAVILY_API_KEY= # optional
Supports any OpenAI-compatible API: DeepSeek, OpenAI, SiliconFlow, Ollama, vLLM, Groq.
Key Features
- Autonomous end-to-end: one command from question to paper
- Honest: no repo → skips experiments with
[NOT VALIDATED]. No data → clearly reported. No GPU → tagged. - Persistent: SqliteSaver + RESEARCH_WIKI.md + sessions + memory across restarts
- ARIS methodology: Problem Anchor, 7-dim scoring, claim-driven, code-review-first
- Anti-hallucination: 3-layer paper verification, never fabricates citations or results
License
MIT
Metadata
Release files for ai-sci-agent 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ai_sci_agent-0.8.1.tar.gz | 110.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ai_sci_agent-0.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 246.0 kB
Release files / ai_sci_agent-0.8.1.tar.gz
| Download URL | ai_sci_agent-0.8.1.tar.gz |
|---|---|
| Size | 110.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9b423c451454b5953faa261bcef685e9ee5c5cfc35d2ff0374b23efcb44c006a
|
|
BLAKE2b-256 checksum How to use checksums |
a12fe0d9391ede25996839c9e539114dbba35f3fe1bbf1c73b927078cc0a27ff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / ai_sci_agent-0.8.1-py3-none-any.whl
| Download URL | ai_sci_agent-0.8.1-py3-none-any.whl |
|---|---|
| Size | 135.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8e19fea3cdddbf264f980e687c099d22c69778305bec2c5d4b3267f5a8a46c9e
|
|
BLAKE2b-256 checksum How to use checksums |
8f9b870f47cd913ec41dab94d991c81f8e75c354f401557c89326236a5492320
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|