OllamaFX 🦙✨

OllamaFX is a modern, native desktop client for Ollama, built with JavaFX. It provides a beautiful, user-friendly interface to manage your local LLMs and chat with them, featuring a sleek GNOME/Adwaita-inspired design.

✨ Features

• 🎨 Modern UI: Clean, responsive interface inspired by GNOME Adwaita, with full Light/Dark mode support.
• 📦 Model Management:

* Install: Browse the Ollama library and download models with a real-time progress popup. * Manage: View installed models, check details (size, format), and uninstall them easily. * Instant Feedback: The UI updates instantly upon installation or deletion.

• 💬 Chat Interface:

* Create multiple chat sessions. * Pin, Rename, and Delete chats. * Clean message bubbles with distinct styles for user and AI.

• 🛠️ Tech Stack: Built on the robust JavaFX platform, utilizing ollama4j for API interaction and AtlantaFX for theming.

� Screenshots

Dark Chat Interface

Light Chat Interface

Library Models Ollama

Init Chat

�🚀 Getting Started

Prerequisites

• Java 17 or higher installed.
• Ollama installed and running locally (ollama serve).

📥 Download & Install

• Go to the Releases Page and download the latest .zip file (e.g., OllamaFX-0.2.0-Dist.zip).
• Unzip the file to a folder of your choice.

▶️ How to Run

We have included easy-to-use scripts for every platform. Just navigate to the unzipped folder and:

• macOS: Double-click run_macOS.command.
• Windows: Double-click run_windows.bat.
• Linux: Run ./run_Linux.sh.

Note: On macOS, if you see a security warning, you may need to right-click the script and select "Open" the first time.

👨‍💻 Development

If you want to build the project from source:

• Clone the repository:

git clone https://github.com/fredericksalazar/OllamaFX.git
    cd OllamaFX

• Run locally:

./gradlew run

• Build Distribution:

./gradlew packageDistribution

This generates the cross-platform ZIP in build/distributions (and copies it to releases/).

🤝 Contributing

Contributions are welcome! Please follow our standard flow:

• Fork the project.
• Create your feature branch (git checkout -b feature/AmazingFeature).
• Commit your changes (git commit -m 'Add some AmazingFeature').
• Push to the branch (git push origin feature/AmazingFeature).
• Open a Pull Request.

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

Built with ❤️ by the OllamaFX Team.