Home

Awesome

<div align="center"> <img src="./screenshots/logo.png" width="300"> </div>

See a video demo.

Chat with your documents using local AI. All your data stays on your computer and is never sent to the cloud. Chatd is a completely private and secure way to interact with your documents.

Chatd is a desktop application that lets you use a local large language model (Mistral-7B) to chat with your documents. What makes chatd different from other "chat with local documents" apps is that it comes with the local LLM runner packaged in. This means that you don't need to install anything else to use chatd, just run the executable.

Chatd uses Ollama to run the LLM. Ollama is an LLM server that provides a cross-platform LLM runner API. If you already have an Ollama instance running locally, chatd will automatically use it. Otherwise, chatd will start an Ollama server for you and manage its lifecycle.

<div align="center"> <img src="./screenshots/chat_screen.png" width="30%"></img> <img src="./screenshots/welcome_screen.png" width="30%"></img> <img src="./screenshots/home_screen.png" width="30%"></img> </div>

Quickstart

  1. Download the latest release from chatd.ai or the releases page.
  2. Unzip the downloaded file.
  3. Run the chatd executable.

Advanced Setup

Links

Development

Run the following commands in the root directory.

npm install
npm run start

Packaging and Distribution

MacOS

  1. Download the latest ollama-darwin release for MacOS from here.
  2. Make the downloaded binary executable: chmod +x path/to/ollama-darwin
  3. Copy the ollama-darwin executable to the chatd/src/service/ollama/runners directory.
  4. Optional: The Electron app needs be signed to be able to run on MacOS systems other than the one it was compiled on, so you need a developer certificate. To sign the app, set the following environment variables:
APPLE_ID=your_apple_id@example.com
APPLE_IDENTITY="Developer ID Application: Your Name (ABCDEF1234)"
APPLE_ID_PASSWORD=your_apple_id_app_specific_password
APPLE_TEAM_ID=ABCDEF1234

You can find your Apple ID, Apple Team ID, and Apple ID Application in your Apple Developer account. You can create an app-specific password here.

  1. Run npm run package to package the app.

Windows

  1. Download the latest ollama-windows-amd64.zip release from here.
  2. Copy the contents of the zip into chatd/src/service/ollama/runners/.
  3. Run npm run package to package the app.

Note: The Windows app is not signed, so you will get a warning when you run it.

Linux

  1. Download the latest ollama-linux-amd64 release from here.
  2. Copy the ollama executable to chatd/src/service/ollama/runners/ollama-linux.
  3. Run npm run package to package the app.