内容摘录
<p align="center">
<a href="https://github.com/hijohnnylin/neuronpedia">
<img src="https://github.com/user-attachments/assets/9bcea0bf-4fa9-401d-bb7a-d031a4d12636" alt="Splash GIF"/>
</a>
<h3 align="center"><a href="https://neuronpedia.org">neuronpedia.org 🧠🔍</a></h3>
<p align="center">
open source interpretability platform
<br />
<sub>
<strong>api · steering · activations · circuits/graphs · autointerp · scoring · inference · search · filter · dashboards · benchmarks · cossim · umap · embeds · probes · saes · lists · exports · uploads</strong>
</sub>
</p>
</p>
<p align="center" style="color: #cccccc;">
<a href="https://github.com/hijohnnylin/neuronpedia/blob/main/LICENSE"><img height="20px" src="https://img.shields.io/badge/license-MIT-yellow.svg" alt="MIT"></a>
<a href="https://status.neuronpedia.org"><img height="20px" src="https://uptime.betterstack.com/status-badges/v2/monitor/1roih.svg" alt="Uptime"></a>
<a href="https://join.slack.com/t/opensourcemechanistic/shared_invite/zt-3m2fulfeu-0LnVnF8yCrKJYQvWLuCQaQ"><img height="20px" src="https://img.shields.io/badge/slack-purple?logo=slack&logoColor=white" alt="Slack"></a>
<a href="mailto:johnny@neuronpedia.org"><img height="20px" src="https://img.shields.io/badge/contact-blue.svg?logo=data:image/svg%2bxml;base64,PHN2ZyB2aWV3Qm94PSIwIDAgMjQgMjQiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PGcgaWQ9IlNWR1JlcG9fYmdDYXJyaWVyIiBzdHJva2Utd2lkdGg9IjAiPjwvZz48ZyBpZD0iU1ZHUmVwb190cmFjZXJDYXJyaWVyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjwvZz48ZyBpZD0iU1ZHUmVwb19pY29uQ2FycmllciI+IDxwYXRoIGQ9Ik00IDcuMDAwMDVMMTAuMiAxMS42NUMxMS4yNjY3IDEyLjQ1IDEyLjczMzMgMTIuNDUgMTMuOCAxMS42NUwyMCA3IiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj48L3BhdGg+IDxyZWN0IHg9IjMiIHk9IjUiIHdpZHRoPSIxOCIgaGVpZ2h0PSIxNCIgcng9IjIiIHN0cm9rZT0iI2ZmZmZmZiIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiPjwvcmVjdD4gPC9nPjwvc3ZnPg==" alt="Email"></a>
<a href="https://neuronpedia.org/blog"><img height="20px" src="https://img.shields.io/badge/blog-10b981.svg" alt="blog"></a>
<a href="https://neuronpedia.org"><img height="20px" src="https://img.shields.io/badge/website-gray.svg" alt="website"></a>
</p>
About Neuronpedia
Setting Up Your Local Environment
"I Want to Use a Local Database / Import More Neuronpedia Data"
"I Want to Do Webapp (Frontend + API) Development"
"I Want to Run/Develop Inference Locally"
'I Want to Run/Develop the Graph Server Locally'
'I Want to Run/Develop Autointerp Locally'
'I Want to Do High Volume Autointerp Explanations'
'I Want to Generate My Own Dashboards/Data and Add It to Neuronpedia'
Architecture
Requirements
Services
Services Are Standalone Apps
Service-Specific Documentation
OpenAPI Schema
Monorepo Directory Structure
Security
Contact / Support
Contributing
Appendix
'Make' Commands Reference
Import Data Into Your Local Database
Why an OpenAI API Key Is Needed for Search Explanations
About Neuronpedia
Check out our blog post about Neuronpedia, why we're open sourcing it, and other details. There's also a tweet thread with quick demos.
**Feature Overview**
A diagram showing the main features of Neuronpedia as of March 2025.
!neuronpedia-features
Setting Up Your Local Environment
Start by setting up your local database.
🔥 **pro-tip:** Neuronpedia is configured for AI agent development. Here's an example using a single prompt to build a custom app (Steerify) using Neuronpedia's inference server as a backend:
https://github.com/user-attachments/assets/bc82f88b-8155-4c1d-948a-ea5d987ae0f8
"I Want to Use a Local Database / Import More Neuronpedia Data"
What This Does + What You'll Get
These steps show you how to configure and connect to your own local database. You can then download sources/SAEs of your choosing:
https://github.com/user-attachments/assets/d7fbb46e-8522-4f98-aa08-21c6529424af
⚠️ **warning:** your database will start out empty. you will need to use the admin panel to import sources/data (activations, explanations, etc).
⚠️ **warning:** the local database environment does not have any inference servers connected, so you won't be able to do activation testing, steering, etc initially. you will need to [configure a local inference instance]().
Steps
Build the webapp
Bring up the webapp
Go to localhost:3000 to see your local webapp instance, which is now connected to your local database
See the warnings above for caveats, and next steps to finish setting up
Next Steps
click here for how to import data into your local database (activations, explanations, etc), because your local database will be empty to start
click here for how to bring up a local inference service for the model/source/SAE you're working with
"I Want to Do Webapp (Frontend + API) Development"
What This Does
The webapp builds you've been doing so far are _production builds_, which are slow to build, and fast to run. since they are slow to build and don't have debug information, they are not ideal for development.
This subsection installs the development build on your local machine (not docker), then mounts the build inside your docker instance.
What You'll Get
Once you do this section, you'll be able to do local development and quickly see changes that are made, as well as see more informative debug/errors. If you are purely interested in doing frontend/api development for Neuronpedia, you don't need to set up anything else!
Steps
Install nodejs via node version manager
Install the webapp's dependencies
Run the development instance
go to localhost:3000 to see your local webapp instance
Doing Local Webapp Development
**auto-reload**: when you change any files in the apps/webapp subdirectory, the localhost:3000 will automatically reload
**install commands**: you do not need to run make install-nodejs again, and you only need to run make webapp-localhost-install if dependencies change
"I Want to Run/Develop Inference Locally"
What This Does + What …