A dockerized tool for studying the Qur'án in its original Arabic, with the help of Google Gemini. Build the container yourself, pull it from Docker Hub, or just run the npm vite project right from the source!

mitch donaberger 8978763630 Update 'README.md' пре 1 месец
public c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
src c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
Dockerfile c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
README.md 8978763630 Update 'README.md' пре 1 месец
docker-compose.yml c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
eslint.config.js c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
index.html c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
package-lock.json c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
package.json c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
postcss.config.js c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец
vite.config.js c54878a12a pushing V 0.1 after successful tests. warning, x86/x64 only right now пре 1 месец

README.md

A screenshot of the Qur'an Study Tool, with an explanation up on the right of the screen

An LLM-Powered Qur'án Study Tool

This is a tool meant to help people study the Qur'án in the original Arabic. It uses Google Gemini to produce translations, word breakdowns, context, or tafsir for the selected 'ayat.

Opens up on port 3000.

Quick Start 🚀

docker run -d -p 3000:3000 --name quran-study-tool unmolded1457/quran-app

or,

docker-compose build && docker run -d -p 3000:3000 --name quran-study-tool unmolded1457/quran-app

TBD

  • Put the git repository up for y'all who like to build your docker containers by hand
  • Add a means of passing API credentials through environment variables
  • Add Ollama as a provider (CORS can be tricky, fair warning)
  • Add DeepSeek as a provider
  • Set script up to pull local versions of the Qur'án text, and to cache answers in an accessible drawer

React + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

React Compiler

The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see this documentation.

Expanding the ESLint configuration

If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the TS template for information on how to integrate TypeScript and typescript-eslint in your project.