π Multi-language Versions:
English | δΈζ | ζ₯ζ¬θͺ | νκ΅μ΄ | FranΓ§ais
A modern, cross-platform desktop application for interacting with Ollama models. Built with React, TypeScript, and Tauri for optimal performance and security.
π€ AI-Powered Development: This project was collaboratively developed using AI-assisted coding (vibe coding) with WindSurf + Cursor + Trae + Lovable (UI and frontend design) + Manus (early research and requirements analysis), primarily powered by Claude 4 and Gemini 2.5 Pro models.
Main Dashboard Interface:
The main dashboard provides an overview of system status, model management, and quick access to key features.
- Multi-model Support: Compatible with OpenAI and DeepSeek models
- Real-time Conversation: Smooth streaming chat experience
- Message Management: Edit, delete, copy, and resend messages
- Conversation History: Persistent chat history with search functionality
- Markdown Rendering: Full support for code highlighting and formatting
AI Chat Interface:
Clean and intuitive chat interface with message history, markdown support, and real-time streaming responses.
Seamlessly blend text and images for richer, more contextual conversations.
Third-party Model API Configuration:
Easy configuration panel for setting up API keys and parameters for OpenAI, DeepSeek, and other AI providers.
- Modern Design: Glass-morphism UI with smooth animations
- Theme System: Multiple built-in themes with gradient effects
- Responsive Layout: Adaptive interface for different screen sizes
- Dark Mode: Eye-friendly dark interface
- Internationalization: Support for English, Chinese, Japanese, Korean, and French
- Model Overview: View and manage available AI models
- Provider Selection: Switch between different AI service providers
- Configuration Management: Easy API key and parameter configuration
Local Model Management:
Comprehensive view of locally installed models with options to manage, update, and remove models.
Local Model Details:
Detailed information about each model including size, parameters, and performance metrics.
Online Model Library:
Browse and discover available models from the Ollama library with one-click download functionality.
Model Information Page:
Comprehensive model details including description, capabilities, and system requirements before download.
Download Management:
Real-time download progress tracking with pause, resume, and cancel options for model installations.
- Cross-platform: Windows, macOS, and Linux support
- Native Performance: Built with Tauri for optimal performance
- Data Persistence: Local storage for settings and chat history
- Keyboard Shortcuts: Efficient keyboard navigation
- Ollama installed and running
- Node.js 18+ and Yarn (for development)
- Rust (for building from source)
- Go to the Releases page
- Download the appropriate installer for your platform:
- MSI Installer:
ollama-pro_x.x.x_x64_en-US.msi(Recommended) - NSIS Installer:
ollama-pro_x.x.x_x64-setup.exe
- DMG Package:
ollama-pro_x.x.x_x64.dmg(Intel) - DMG Package:
ollama-pro_x.x.x_aarch64.dmg(Apple Silicon) - App Bundle:
ollama-pro.app.tar.gz
Warning
macOS Special Note: If you encounter a "file is damaged" error when trying to open the application, please run the following command in your terminal. This issue occurs because the application is not yet notarized by Apple.
sudo xattr -rd com.apple.quarantine /Applications/ollama-pro.appReplace /Applications/ollama-pro.app with the actual path to the application if you installed it elsewhere.
- Debian Package:
ollama-pro_x.x.x_amd64.deb(Ubuntu/Debian) - RPM Package:
ollama-pro_x.x.x_x86_64.rpm(RHEL/Fedora/SUSE) - AppImage:
ollama-pro_x.x.x_amd64.AppImage(Universal)
# Clone the repository
git clone https://github.com/downly-app/ollama.vip.git
cd ollama.vip
# Install dependencies
yarn install
# Start development server
yarn tauri:dev
# Build for production
yarn tauri:build
# Or use platform-specific build scripts
# Windows
yarn build:all
# Linux/macOS
yarn build:all:unixOur GitHub Actions automatically build releases for all supported platforms:
- β Windows (x64)
- β macOS (Intel & Apple Silicon)
- β Linux (x64)
All builds are:
- π Digitally signed (when certificates are available)
- π‘οΈ Security scanned for vulnerabilities
- π¦ Optimized for size and performance
- π§ͺ Tested across multiple environments
- Install and Launch: Download and install the application for your platform
- Configure API: Open settings and add your AI provider API key
- Select Model: Choose your preferred AI model from the dropdown
- Start Chatting: Begin your conversation with the AI assistant
ollama.vip/
βββ src/ # Frontend source code
β βββ components/ # React components
β β βββ ui/ # Base UI components
β β βββ layouts/ # Layout components
β β βββ ...
β βββ pages/ # Page components
β βββ stores/ # Zustand state management
β βββ services/ # API services
β βββ utils/ # Utility functions
β βββ contexts/ # React contexts
β βββ i18n/ # Internationalization
β β βββ locales/ # Translation files
β βββ styles/ # CSS styles
βββ src-tauri/ # Tauri backend
β βββ src/ # Rust source code
β βββ Cargo.toml # Rust dependencies
β βββ tauri.conf.json # Tauri configuration
βββ public/ # Static assets
βββ docs/ # Documentation
- Open the application
- Click the settings icon in the toolbar
- Configure your API provider and key:
- OpenAI: Enter your OpenAI API key
- DeepSeek: Enter your DeepSeek API key
- Select your preferred model
- Adjust temperature and other parameters
The application supports multiple languages:
- English (default)
- Chinese (Simplified)
- Japanese
- Korean
- French
Change language in Settings > Language Settings.
- Frontend: React 18.3 + TypeScript 5.5
- Backend: Tauri 1.5 + Rust
- UI Framework: Tailwind CSS + Radix UI
- State Management: Zustand
- Build Tool: Vite
- Internationalization: react-i18next
- Code Editors: WindSurf + Cursor + Trae AI
- UI/UX Design: Lovable
- Research & Analysis: Manus
- AI Models: Claude 4 + Gemini 2.5 Pro
- Development Approach: Vibe Coding (AI-assisted development)
# Start development server
npm run dev
# Start Tauri development
npm run tauri dev
# Build for production
npm run tauri build
# Type checking
npm run type-check
# Linting
npm run lint
# Format code
npm run format- Create components in
src/components/ - Add pages in
src/pages/ - Manage state with Zustand stores in
src/stores/ - Add translations in
src/i18n/locales/ - Update types in appropriate
.d.tsfiles
The application supports multiple AI providers:
- Models: GPT-4o, GPT-4o Mini, GPT-4 Turbo
- Endpoint:
https://api.openai.com/v1/chat/completions
- Models: DeepSeek-V3, DeepSeek-R1
- Endpoint:
https://api.deepseek.com/v1/chat/completions
interface AIConfig {
provider: 'openai' | 'deepseek';
apiKey: string;
model: string;
temperature: number;
}# Run unit tests
npm run test
# Run integration tests
npm run test:integration
# Run e2e tests
npm run test:e2enpm run tauri devnpm run tauri buildBuild artifacts will be generated in src-tauri/target/release/bundle/.
- Windows: Generates
.msiinstaller - macOS: Generates
.dmgand.appbundle - Linux: Generates
.deband.AppImage
-
Port 1421 already in use
# Kill the process using the port npx kill-port 1421 # or lsof -ti:1421 | xargs kill -9
-
Tauri build fails
- Ensure Rust is properly installed
- Update Tauri CLI:
cargo install tauri-cli - Clear cache:
cargo clean
-
API connection issues
- Verify API key is correct
- Check network connectivity
- Ensure API endpoint is accessible
Enable debug mode by setting environment variable:
TAURI_DEBUG=true npm run tauri devWe welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
- Use TypeScript for type safety
- Follow ESLint configuration
- Use Prettier for code formatting
- Write meaningful commit messages
This project is licensed under the GNU General Public License v3 with Commercial Exception.
For non-commercial use (personal, educational, research), this software is available under GPL v3 terms.
Commercial use requires a separate commercial license. Contact us at [[email protected]] for commercial licensing.
See the LICENSE file for complete details.
- Tauri - For the amazing desktop app framework
- React - For the UI library
- Tailwind CSS - For the utility-first CSS framework
- Radix UI - For accessible UI components
- Zustand - For state management
- WindSurf - AI-powered code editor
- Cursor - AI-first code editor
- Trae AI - Advanced AI coding assistant
- Lovable - AI-powered UI/UX design
- Manus - AI research and analysis platform
- Claude 4 - Advanced AI language model by Anthropic
- Gemini 2.5 Pro - Google's advanced AI model
This project demonstrates the power of AI-assisted development (vibe coding), where human creativity and AI capabilities work together to create innovative software solutions.
If you encounter any issues or have questions:
- Create an issue on GitHub Issues
- Check the Documentation
- Join our community discussions
- For commercial licensing inquiries: [[email protected]]