oxproxion  by stardomains3

LLM chat application for Android

Created 8 months ago
263 stars

Top 96.9% on SourcePulse

GitHubView on GitHub
Project Summary

oxproxion is an Android chat application designed for seamless interaction with various Large Language Models (LLMs). It targets Android users seeking a versatile interface to manage conversations, customize AI personas, and integrate with both cloud-based (OpenRouter) and locally-served LLMs (Ollama, LM Studio, etc.). The primary benefit is a unified, user-centric experience for diverse LLM interactions on mobile devices.

How It Works

Built with modern Android technologies including Jetpack libraries, Kotlin Coroutines for asynchronous operations, and Ktor for networking, oxproxion employs an MVVM architecture. It facilitates communication with LLM backends via API calls to OpenRouter or direct network connections to local servers like Ollama or LM Studio running on a user's LAN. Key features include streaming/non-streaming responses, image chat, and on-device PDF export, offering flexibility and local control.

Quick Start & Requirements

To build and run, clone the repository (https://github.com/stardomains3/oxproxion.git) and open it in the latest version of Android Studio. Building and installing is done via Android Studio's "Run" button. Configuration requires either an OpenRouter.ai API key or a properly configured local LLM server endpoint (Ollama, LM Studio, llama.cpp, MLX LM, Hermes Agent) accessible on the user's LAN. Note: This project does not provide setup guidance for local LLM infrastructure.

Highlighted Details

  • Multi-Model Support: Integrates with OpenRouter models and locally served models via Ollama, LM Studio, llama.cpp, MLX LM, or Hermes Agent.
  • Rich Chat Features: Supports image generation, chat with images (for vision models), system message customization, and configurable presets.
  • Data Management: Enables saving, loading, importing, and exporting chat histories, with on-device PDF export for full chats or individual responses.
  • User Experience: Offers customizable fonts, a conversation mode with text-to-speech, and effortless response copying (plain text or Markdown).

Maintenance & Community

The README does not specify notable contributors, sponsorships, or community channels (e.g., Discord, Slack). The project appears to be maintained by the individual developer(s) at stardomains3.

Licensing & Compatibility

This project is licensed under the Apache License 2.0. This license generally permits commercial use and integration into closed-source applications, with attribution requirements.

Limitations & Caveats

Chats are stored unencrypted on the device only. The application requires users to set up their own local LLM infrastructure if not using OpenRouter, with no guidance provided for server setup. The app is intended for users 18 and over and is provided "as-is" without warranty.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
9
Star History
31 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.