whatisgithub

What is tera?

aurielsolaris/tera — explained in plain English

Analysis updated 2026-05-18

1DartAudience · generalComplexity · 3/5Setup · moderate

In one sentence

A private, offline-first app for keeping profiles, chats, and lore about fictional partners and companions, with no accounts or servers.

Mindmap

mindmap
  root((Tera))
    What it does
      Fictional partner companion app
      Offline first
      No accounts or servers
    Tech stack
      Flutter
      Dart
      SQLite
    Use cases
      Partner profiles
      Wake up alarms
      Manual or AI chat
    Audience
      Personal use
      Fiction enthusiasts

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

Build a profile for a fictional partner and set up personalized wake up alarms.

USE CASE 2

Write manual roleplay conversations or chat using your own AI provider key.

USE CASE 3

Organize world and lore notes that link back to your partners.

USE CASE 4

Store partner photos locally in an offline image gallery.

What is it built with?

DartFlutterSQLite

How does it compare?

aurielsolaris/teraabhishek-kumar09/mini_project1arsalankaleem/aestimo
Stars111
LanguageDartDartDart
Last pushed2020-01-30
MaintenanceDormant
Setup difficultymoderatemoderate
Complexity3/51/5
Audiencegeneralvibe codergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing the Flutter SDK and building for your target platform since it isn't on app stores.

So what is it?

Tera is a private, offline-first app built with Flutter and Dart for people who want to keep a personal collection of fictional partners, imagined companions, or alternate versions of characters they care about. Everything is stored locally in a single SQLite database on the device, there are no accounts, no servers, and no telemetry. The only time the app talks to the internet is if you choose to connect your own AI provider key for chat replies. Inside the app you can build rich profiles for each partner, including relationship type, anniversary date, and notes about alternate selves linked to a base character. You can set up to five alarms per partner with custom wake up messages, and on Android these alarms use real scheduled notifications that still fire when the app is closed. On Windows and Linux the alarms only ring while the app is open. Conversations work in two modes: a manual mode where you write both sides of the dialogue yourself, or a BYOK, bring your own key, AI mode where your partner replies using an AI service you connect. The app also includes world and lore hubs so you can organize backstory and settings, plus a local image gallery stored losslessly as PNG files for each partner. Tera is designed around a few guiding rules: no placeholder or sample data cluttering a fresh install, no guilt based mechanics pushing you to use it more, and no pretending to be online or connected when a permission or service actually fails. The project currently supports Android, Windows, and Linux in beta form, with iOS unplanned since the developer does not own Apple hardware. To install on Android, you download an APK directly from the GitHub releases page rather than the Play Store, matching the file to your phone's processor type. The README includes a full beginner's walkthrough for that installation process. Running the app from source requires the Flutter SDK for Dart 3.12 or newer.

Copy-paste prompts

Prompt 1
Help me set up the Flutter SDK and run Tera from source on my machine.
Prompt 2
Explain how Tera's BYOK AI messaging mode connects to an AI provider so I can configure it.
Prompt 3
Show me how the SQLite database schema for partners and lore is structured in Tera.
Prompt 4
Walk me through building the Android APK for Tera using the split per abi release build.

Frequently asked questions

What is tera?

A private, offline-first app for keeping profiles, chats, and lore about fictional partners and companions, with no accounts or servers.

What language is tera written in?

Mainly Dart. The stack also includes Dart, Flutter, SQLite.

How hard is tera to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is tera for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.