Installation

Requirements

Requirement	Version	Note
Python	3.10 or newer	The CLI and the agent runtime.
Node.js	18 or newer	Only needed for the skills installer.
API key	none	Science ADK runs deterministic agents offline.

Install from source

Science ADK is not published to PyPI or npm yet, so install from the repository:

git clone https://github.com/twmmason/science-adk
pip install ./science-adk/python

Check it:

science-adk --version

science-adk 0.1.0

Use a virtual environment

python -m venv .venv && source .venv/bin/activate
pip install ./science-adk/python

Optional extras

The core install depends only on google-adk. Everything else is opt-in:

Scientific stackMCP serversDevelopmentEverything

For the bundled example and most numerical work:

pip install "./science-adk/python[examples]"

Adds numpy, pandas and matplotlib.

To call Model Context Protocol tools:

pip install "./science-adk/python[mcp]"

Adds the mcp client library.

To run the test suite and the linter:

pip install -e "./science-adk/python[dev]"
cd science-adk/python && pytest -q && ruff check src tests

pip install "./science-adk/python[examples,mcp,dev]"

Verify with a real run

The fastest end-to-end check queries live data and takes about thirty seconds:

science-adk init /tmp/verify --example kepler
cd /tmp/verify
science-adk validate
science-adk run

If the run prints a recovered exponent near 1.46 and all six gates pass, the install is sound. The quickstart explains what just happened.

What gets installed

Artifact	Where it comes from
science-adk command	[project.scripts] in python/pyproject.toml
science_adk Python package	python/src/science_adk/
Project template	science_adk/template/, copied by science-adk init
Kepler example	science_adk/examples/kepler/, copied by --example kepler
Coding-agent skills	skills/, installed separately by node bin/install.mjs

Next

Run the Kepler quickstart