https://github.com/cushydigit/lumina
A lightweight frontend web application built with React.js for interacting with the Ollama API Localy.
https://github.com/cushydigit/lumina
ai chatbot ollama ollama-client react
Last synced: 5 months ago
JSON representation
A lightweight frontend web application built with React.js for interacting with the Ollama API Localy.
- Host: GitHub
- URL: https://github.com/cushydigit/lumina
- Owner: cushydigit
- License: mit
- Created: 2025-04-16T10:43:10.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-10T18:35:23.000Z (11 months ago)
- Last Synced: 2025-08-10T20:34:31.259Z (11 months ago)
- Topics: ai, chatbot, ollama, ollama-client, react
- Language: TypeScript
- Homepage:
- Size: 2.99 MB
- Stars: 9
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Lumina (Ollama Web Client)
A lightweight, minimalistic frontend built with React.js for interacting with the Ollama API.
Designed with minimal dependencies for simplicity, speed, and easy customization.
## 🚀 Features
- Minimal dependencies - build with React only
- Streamed conversations with Ollama models
- Persistent Converstaion history
- Markdown rendering with syntax highlighting
- Support Two modes: **Chat** and **Completion**
- Allow users to define or tweak the system prompt for better control.
- Copy code blocks or entire messsage easily
- Automatic title genreation for conversations
- Exlusive Reasoning Component
- Clean, Reponsive UI
## 📸 Screenshot
## 🛠️ Tech Stack
- React.js
- Tailwindcss
- shadcn/ui
## 📦 Getting Started
Clone the repository and install dependecies:
```bash
git clone https://github.com/cushydigit/lumina.git
cd lumina
npm install
npm run dev
```
or easily use lamina with Docker way:
build then docker image
```bash
docker build -t lumina .
```
run the docker container
```bashe
docker run =p 4173:4173 lumina
```
Make sure your Ollama server is running locally at (localhost:11434) or update the API URL if needed.
## ⚙️ Configuration
if your Ollama instance is runnig elsewhere, you could easily edit the API_BASE_URL in api.ts file if needed.
```ts
const API_BASE_URL = "http://localhost:11434";
```
## 📄 License
This porject is licensed under the MIT License.
## 🙌 Contributing
pull requiest, suggestions, and feedback are welcome!
## 🛣️ Roadmap / Upcoming Features
- [ ] **Delete and Retry Messages**
Allow users to delete messages or retry sending failed messages.
- [ ] **Model Pulling Support**
UI for pulling, updating, and managing Ollama models directly.
- [ ] **Conversation Pinning**
Pin important conversations to the top for quick access.
- [ ] **Search Conversations**
Quickly search across conversations by keywords.
- [ ] **Export / Import Conversations**
Allow users to back up and restore chats in JSON or Markdown format.
## 🔗 Related Links
- [Ollama Official Website](https://ollama.com/)
- [Ollama Official Repository](https://github.com/ollama/ollama)
- [Ollama Developement Documention](https://github.com/ollama/ollama/blob/main/docs/development.md)