Skip to content

techcow2/lmsa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 

Repository files navigation

LMSA - LM Studio Android Front-End

Table of Contents

Google Pixel 4 XL Screenshot 0 Google Pixel 4 XL Screenshot 2 Google Pixel 4 XL Screenshot 3 Google Pixel 4 XL Screenshot 1

Overview

LMSA (LM Studio Assistant) is an open-source Android front-end application for LM Studio. It provides a clean, user-friendly interface to interact with language models on your Android device. LMSA is designed with privacy in mind, offering a tracking-free and ad-free experience for users who want to leverage the power of large language models on their mobile devices.

Features

🔒 Privacy-Focused

  • No Tracking: Your data and interactions remain private.
  • Ad-Free: Enjoy a clean, distraction-free experience.

💬 Customizable Interactions

  • System Prompt: Set and modify the system prompt to guide your AI interactions.
  • Adjustable Temperature: Fine-tune the LLM's creativity directly from your device.

📱 User-Friendly Interface

  • Clean Design: Intuitive and minimalistic UI for effortless navigation.
  • Model Display: Easily view the currently loaded language model on your device.

🛠 Technical Highlights

  • Open Source: Transparent codebase, open for community contributions and audits.
  • LM Studio Integration: Seamless connection with LM Studio's powerful language model capabilities.

Requirements

Before using LMSA, ensure that the following requirements are met:

  • Android Device: You must have a device running Android 7.0 (Nougat) or higher.
  • LM Studio: LM Studio must be installed and running on a network-accessible computer.
  • Network Configuration:
    • CORS (Cross-Origin Resource Sharing) must be enabled in LM Studio settings to allow cross-origin requests from LMSA.

Installation

  1. Clone the repository:
    git clone https://github.com/techcow2/lmsa.git
  2. Open the project in Android Studio.
  3. Build and run the app on your Android device or emulator.

Alternatively, download the latest APK from the Releases page.

Usage

  1. Run LM Studio: Start LM Studio on your computer.
  2. Enable Server: Run the server within LM Studio.
  3. Load Model: Load the model of your choice in LM Studio.
  4. Network Configuration:
    • Ensure CORS and network sharing are enabled in LM Studio settings.
  5. Copy IP Address: Find and copy the IP address of your computer.
  6. Connect LMSA to LM Studio:
    • Launch the LMSA app on your Android device.
    • Navigate to the Settings menu in LMSA.
    • Enter the copied IP address in the designated field.
    • Tap 'Close' to save the settings.
  7. Interact with the Model: Start interacting with the AI model through LMSA's clean interface.

Configuration

Setting the System Prompt

  1. Navigate to the Settings menu.
  2. Find the "System Prompt" section.
  3. Enter your desired system prompt to guide the AI's behavior.

Adjusting LLM Temperature

  1. During a conversation, locate the temperature slider.
  2. Adjust the slider to increase (more creative) or decrease (more focused) the temperature.

Viewing Loaded Model

The currently loaded model will be displayed at the top of the main interface.

Contributing

We welcome contributions to LMSA! If you'd like to contribute, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and commit them with clear, descriptive messages.
  4. Push your changes to your fork.
  5. Submit a pull request to the main repository.

Disclaimer

LMSA is a third-party application and is not affiliated with LM Studio or its developers. This app is independently developed to provide an Android front-end interface for interacting with LM Studio. Use of this app is at your own discretion, and the developers of LMSA are not responsible for any issues arising from its use.

License

LMSA is released under the MIT License. Feel free to use, modify, and distribute the code as per the license terms.