Run a powerful conversational AI locally with this open-source project
R

Run a powerful conversational AI locally with this open-source project

Run a powerful conversational AI locally with this open-source project

55,659 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Run a Conversational AI Locally with NanoChat

Ever wanted to tinker with a conversational AI without dealing with API keys, usage limits, or sending your data off to a third-party server? That’s exactly the itch that NanoChat scratches. It’s a lightweight, open-source project that lets you run a capable chat model entirely on your own machine. For developers, this means privacy, full control, and the freedom to experiment without any cost per query.

The project comes from Andrej Karpathy, whose work often focuses on making AI more accessible and understandable. NanoChat continues that trend by stripping away the complexity and infrastructure usually needed to run these models, packaging it into something you can get running in a few minutes.

What It Does

NanoChat is a local chatbot interface built around a small, efficient language model. It provides a clean, terminal-based chat interface where you can have conversations, ask questions, or generate text. The entire stack runs locally—the model weights are downloaded to your machine, and all inference happens using your own CPU or GPU. It’s designed to be simple, with no external dependencies on commercial services.

Why It’s Cool

The real appeal here is the simplicity and the local-first approach. There’s no backend server to set up, no authentication, and no network latency. Everything is self-contained. This makes it perfect for:

  • Learning and Experimentation: Want to understand how conversational AI works under the hood? This is a great sandbox.
  • Privacy-Sensitive Tasks: Process documents, brainstorm ideas, or draft code without any data leaving your computer.
  • Offline Use: It works completely offline after the initial model download.
  • A Foundation for More: The codebase is clean and focused, making it an excellent starting point if you want to build your own customized local AI tooling.

It’s a reminder that powerful AI doesn’t always require a massive cluster of GPUs or a cloud connection—sometimes, a capable model running efficiently on consumer hardware is all you need for a great interactive experience.

How to Try It

Getting started is straightforward. You’ll need Python installed on your system. Here are the basic steps:

  1. Clone the repository:

    git clone https://github.com/karpathy/nanochat.git
    cd nanochat
    
  2. Install the required package: The project uses a minimal dependency, llama-cpp-python.

    pip install llama-cpp-python
    

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Mar 25, 2026