neuronpedia

(★ 1,114)

open source interpretability platform 🧠

File Explorer

Download Latest Version (.zip)

- settings.json
- hooks.json
- mcp.json
- settings.json
- install.js
- pre-commit
- - bug-report.md
  - feature-request.md
- - check_agent_rules.py
  - check_lint_config_parity.py
  - check_no_local_path_deps.py
  - check_openapi_specs.py
  - publish_sdk.py
- - agent-rules.yml
  - autointerp-tests.yml
  - codecov.yml
  - graph-nla-sparsity-tests.yml
  - inference-gpu-tests.yml
  - inference-tests.yml
  - model-expectations-manual.yml
  - openapi-drift.yml
  - openapi-publish.yml
  - python-lint.yml
  - semantic-versioning-release.yml
  - webapp-lint.yml
- copilot-instructions.md
- dependabot.yml
- pull_request_template.md
- settings.json
- - .gitignore
  - dump_openapi.py
  - Makefile
  - openapi.json
  - pyproject.toml
  - README.md
  - server.py
  - uv.lock
- - .env.example
  - .gitignore
  - dump_openapi.py
  - Makefile
  - NOTICE
  - openapi.json
  - pyproject.toml
  - README.md
  - start.py
  - uv.lock
- - .gitignore
  - dump_openapi.py
  - Makefile
  - openapi.json
  - pyproject.toml
  - README.md
  - start.py
  - uv.lock
- - .gitignore
  - __init__.py
  - api_demo.ipynb
  - chat_template_spans.py
  - dump_openapi.py
  - eager_verbalizer.py
  - Makefile
  - nla_inference.py
  - openapi.json
  - pyproject.toml
  - README.md
  - server.py
  - startup_memory.py
  - uv.lock
  - vllm_verbalizer.py
- - .gitignore
  - __init__.py
  - dump_openapi.py
  - Makefile
  - openapi.json
  - pyproject.toml
  - README.md
  - schemas.py
  - server.py
  - uv.lock
- - .env.example
  - .env.localhost
  - .gitignore
  - .npmrc
  - .prettierignore
  - .prettierrc
  - AGENTS.md
  - CLAUDE.md
  - components.json
  - eslint.config.mjs
  - instrumentation-client.ts
  - instrumentation.ts
  - knip.json
  - mdx-components.tsx
  - middleware.ts
  - next.config.js
  - package-lock.json
  - package.json
  - postcss.config.js
  - sentry.edge.config.ts
  - sentry.server.config.ts
  - tailwind.config.js
  - tsconfig.json
  - vitest.config.mts
- CROSS_SERVER_APIS.md
- - openapi-stop.sh
  - openapi-track.sh
  - pyright-stop.sh
  - pyright-track.sh
  - ruff-format.sh
- - backfill_spans.py
  - README.md
- - .gitignore
  - poetry.lock
  - pyproject.toml
  - README.md
- - __init__.py
  - np_activation.py
  - np_explanation.py
  - np_feature.py
  - np_graph_metadata.py
  - np_list.py
  - np_model.py
  - np_sae_feature.py
  - np_source.py
  - np_source_set.py
  - np_vector.py
  - sample_data.py
- - __init__.py
  - test_vector.py
- .gitignore
- LICENSE
- pyproject.toml
- README.md
- uv.lock
.aider.conf.yml
.env.inference.deepseek-r1-distill-llama-8b.llamascope-slimpj-res-32k
.env.inference.gemma-2-2b-it.gemmascope-res-16k
.env.inference.gpt2-small.res-jb
.gitignore
AGENTS.md
architecture.key
architecture.png
CLAUDE.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
LICENSE-MIT
Makefile
NOTICE
np_model_to_hf.json
README.md
SECURITY.md
vercel.json

# Installation Guide

1. Get the code

git clone https://github.com/hijohnnylin/neuronpedia

Downloads the entire project code from GitHub to your computer.

cd neuronpedia

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Homebrew A package manager for macOS/Linux.
APT (Debian/Ubuntu 계열) Built into Debian/Ubuntu-based Linux distributions.

brew install postgresql@16 pgvector && brew services start postgresql@16

Installs the pre-built package via Homebrew — no source build required.

sudo apt install postgresql-16 postgresql-16-pgvector && sudo systemctl start postgresql

Installs directly from the APT package repository (Debian/Ubuntu-based).

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

⚠️ This is a large repository, so this method may point to an internal sub-package rather than the actual core product. Check the full README as well.

cd apps/webapp

This project's files live in a subfolder, so move into it first.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

4. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

poetry lock && poetry install # install dependencies

Installs the libraries listed in pyproject.toml.

poetry remove sae-lens # remove production dependency

Type this command into your terminal and run it.

poetry add PATH/TO/CLONED/SAELENS # set local dependency

Type this command into your terminal and run it.

poetry run neuronpedia-runner \

Type this command into your terminal and run it.

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

5. Make

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).

make db-check