# Kotaemon

> Chat with your documents and see the cited passage in each answer.

- Page: https://cgt.octabyte.io/templates/kotaemon/
- Category: AI
- Replaces: ChatPDF and NotebookLM
- Ease of use: Some setup. Sign in as admin with the password Cloudgate generates, add an AI provider key or a local model, then upload your first files.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: Apache-2.0
- Good for: Teams that want answers from their PDFs with the cited passage highlighted
- Official website: https://cinnamon.github.io/kotaemon/
- Documentation: https://cinnamon.github.io/kotaemon/
- Source code: https://github.com/Cinnamon/kotaemon
- Last updated: 2026-11-20

## What is Kotaemon?

Kotaemon is a self-hosted ChatPDF alternative to chat with your documents: ask about your PDFs and get answers that cite and highlight the source.

Kotaemon is a free, open-source app to chat with your documents on your own server, a self-hosted alternative to ChatPDF and NotebookLM. You upload PDFs and other files, ask questions in plain words, and every answer cites its sources: the document opens beside the chat with the quoted passage highlighted, so you can check it before you rely on it.

It is made for teams as well as one person. Each colleague gets an account, files can sit in private or shared collections, and a useful conversation can be shared with the others. A property manager, for example, could upload the tenancy agreements for every building, ask "what is the notice period for unit 4 on Mill Street?" and open the cited clause to confirm it.

Kotaemon works with the AI provider you choose, such as OpenAI, Azure OpenAI, Cohere or Groq, or with a local model on Ollama so your documents never leave your servers. It is a web app, with no phone or desktop apps.

Cloudgate installs Kotaemon on a server Cloudgate provides or one you connect and gives it a secure web address. Sign in as admin with the password Cloudgate generates, add your AI provider, and upload your first files.

## What you can do with Kotaemon

- **Ask questions about your files**: Upload PDFs and other documents, then ask in plain words and get an answer drawn from them.
- **Check every answer**: Each answer cites its sources, and the PDF opens beside the chat with the quoted passage highlighted.
- **See how relevant the sources are**: Relevance scores show how well each source matches your question, with a warning when nothing fits well.
- **Ask across several documents**: Search all your files at once or pick the ones that matter, including tables and figures inside them.
- **Choose your AI**: Use OpenAI, Azure OpenAI, Cohere or Groq, or run a local model through Ollama so your files stay private.
- **Share with your team**: Give each person an account, keep private or shared file collections, and share a conversation with colleagues.
- **Get a mind map of an answer**: Turn a long answer into a mind map that shows how its ideas fit together.

## Replaces ChatPDF and NotebookLM

Kotaemon does the same job as ChatPDF and NotebookLM. Here is what changes when you switch.

### What you gain

- No daily document limit of its own
- Your files stay on your server, not with a chat service
- Several users, with shared collections and shared conversations
- You choose the AI, including local models

### What is different

- You connect your own AI provider key or run a local model
- This edition reads PDF, web page, spreadsheet and text files, not Word files
- Chats from ChatPDF or NotebookLM do not move across
- No phone apps, audio overviews or web-page sources

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=kotaemon

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Kotaemon itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up Kotaemon.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is Kotaemon free?

Yes, Kotaemon is free and open source under the Apache 2.0 licence, with no paid edition. You pay for your server and for the AI provider you connect, or nothing extra if you run a local model.

### Is Kotaemon a good alternative to ChatPDF?

Yes, if you want to chat with your PDFs on your own server. Like ChatPDF, it answers from your documents with citations, and it adds user accounts, shared file collections and the AI model of your choice. ChatPDF's free plan stops at 2 documents a day; Kotaemon has no limit of its own, but it needs your own AI key and some setup.

### Which AI does Kotaemon need?

Kotaemon needs at least one language model and one embedding model, which powers search. Add them in the Resources tab, either from a provider such as OpenAI, Azure OpenAI, Cohere or Groq, or from a local model running on Ollama, which keeps your documents off outside services.

### How do I sign in to Kotaemon the first time?

Open the app's web address and sign in with the username admin and the password Cloudgate generated, shown on the app's variables page. Kotaemon's usual admin / admin login does not work on a Cloudgate install.

### Can several people use one Kotaemon?

Yes, the Kotaemon admin creates an account for each person under Resources > Users. Each person has private files and conversations, and can also use public file collections and share a conversation with the others.

### Which files can Kotaemon read?

This edition reads PDF, HTML and MHTML web pages, Excel (.xlsx) and text files. Word and other Office files need Kotaemon's larger full edition.

### Can I import my ChatPDF or NotebookLM chats into Kotaemon?

No, Kotaemon has no import from ChatPDF or NotebookLM. Upload the same documents again and ask your questions in Kotaemon.

### Do I need technical skills to run Kotaemon?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Kotaemon and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for Kotaemon?

No. When you deploy Kotaemon, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
