whatisgithub

What is personachat?

caiecii/personachat — explained in plain English

Analysis updated 2026-05-18

0Audience · generalComplexity · 2/5Setup · easy

In one sentence

A local Android chat app for talking with custom AI personas using your own free Gemini API key, no account or subscription required.

Mindmap

mindmap
  root((repo))
    What it does
      Local AI chat
      Custom personas
      No server storage
    Tech stack
      Android
      Gemini API
    Use cases
      Chat with characters
      Roleplay locally
      Export chat data
    Audience
      Roleplay hobbyists
      Privacy-focused users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Chat with custom AI characters entirely offline-stored on your Android phone.

USE CASE 2

Build and roleplay with unlimited custom personas without a subscription.

USE CASE 3

Import and export your chat data when switching to a new phone.

What is it built with?

AndroidGemini API

How does it compare?

caiecii/personachat0verflowme/alarm-clock0xhassaan/nn-from-scratch
Stars00
LanguageCSSPython
Last pushed2022-10-03
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires getting your own free Gemini API key from Google to send messages.

So what is it?

PersonaChat is an Android app for chatting with custom AI characters, built to run fully on your phone with no account, no subscription, and no server storing your conversations. Everything you type and every character you build stays local to your device. It uses a bring your own key model, meaning you connect it to your own Gemini API key from Google rather than paying the app's developer for access. The app lets you create an unlimited number of characters or personas to chat with, and includes several small quality of life features: labeling your roleplay chats, changing chat colors, rewinding or editing messages, pinning important messages, archiving old chats, and customizing the app's fonts and color scheme. You can write custom instructions for a character, similar to what other roleplay chat apps call a lorebook, and you can fully delete chats or import and export your data so you do not lose anything if you switch phones. Because there is no server component, there is also no shared feed or discovery of other people's characters. The only characters that exist in your copy of the app are the ones you build yourself. The README explains this is a deliberate choice to avoid running paid servers and to keep the app free of subscriptions. The README's FAQ section notes that if you have not paid for Gemini API credits, the free Gemma model tier still allows unlimited messages, while other models are meant for users willing to pay for their own usage. It also confirms there are no current plans to support iOS or iPadOS, since that would require a Mac and additional cost the developer does not have.

Copy-paste prompts

Prompt 1
Walk me through getting a Gemini API key to use with this app.
Prompt 2
Explain how the custom instructions feature compares to a roleplay lorebook.
Prompt 3
Help me understand why I can't send messages and how to fix API key setup.
Prompt 4
Show me how to back up and transfer my PersonaChat data to a new device.

Frequently asked questions

What is personachat?

A local Android chat app for talking with custom AI personas using your own free Gemini API key, no account or subscription required.

How hard is personachat to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is personachat for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.