mallahyari
ai-starter-kit
JavaScript

A Web app stack written in FastAPI, Qdrant, and React for creating AI projects

Last updated Aug 5, 2026
54
Stars
14
Forks
1
Issues
0
Stars/day
Attention Score
17
Language breakdown
JavaScript 55.0%
Python 20.4%
TypeScript 18.5%
HTML 3.3%
CSS 2.8%
โ–ธ Files click to expand
README

AI Starter Kit

A minimal code base for creating AI apps to do Question Answering (QA) over PDF documents, completely locally.

This project is inspired by local-ai-stack. However, their stack is entirely javascript based, and I needed a python based backend_, so decided to create this project.

https://github.com/mallahyari/ai-starter-kit/assets/28068313/5b65f268-d5e2-499e-92ca-38dc4067e940

Stack

How to get started

  • Clone this repo:
git clone https://github.com/mallahyari/ai-starter-kit.git
  • Install backend dependencies:
cd backend/app
pip install -r requirements.txt
  • Install frontend dependencies:
cd frontend
npm install
  • Start the Qdrant vector database (you need Docker). See here for other options information:
docker run -p 6333:6333 qdrant/qdrant
  • Install Ollama
Instructions are here
  • Run the FastApi server (from inside backend directory):
python app/main.py
  • Open a new terminal and start the React development server (from inside frontend):
npm start

Change Configurations

You can change configurations in .config file, such as the embedding model, chunk size, and chunk overlap. If you plan to use Qdrant Cloud, you can or you can create your own .env file and set necessary api keys.

Additional Use Cases

Although current app only support pdf files, it's very straightforward to add other types of files such as text files, etc. Also, you can easily add the open-ended chat in addition to QA over document use case.

Discussion and Contribution

If you have any comment or feedback, please don't hesitate to use the Discussions section and open a new topic. You can also reach out directly via Linkedin or Twitter

๐Ÿ”— More in this category

ยฉ 2026 GitRepoTrend ยท mallahyari/ai-starter-kit ยท Updated daily from GitHub