whatisgithub

What is aphelion?

penpro/aphelion — explained in plain English

Analysis updated 2026-05-18

12TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A free desktop app that runs an AI model entirely offline on your PC for chat, roleplay, story writing, and document generation.

Mindmap

mindmap
  root((repo))
    What it does
      Local offline AI
      Roleplay and story writing
      Document generation
    Tech stack
      Tauri
      llama.cpp
      TypeScript
    Use cases
      Chat with AI offline
      Ask questions about your files
      Generate PDFs and code files
    Audience
      Privacy focused users
      Writers and hobbyists
    Safety
      Not an autonomous agent
      No file or network access on its own

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 an AI model completely offline once the initial model download finishes.

USE CASE 2

Ask questions about a folder of your own PDFs or notes without uploading them anywhere.

USE CASE 3

Write stories, roleplay with characters, or build branching dialogue trees.

USE CASE 4

Generate finished PDFs, code files, or Markdown documents saved directly to your computer.

What is it built with?

Taurillama.cppTypeScript

How does it compare?

penpro/aphelionalamops/agetoraza-ali/blendpixel.com
Stars121212
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 30min

First launch downloads an AI model sized for your hardware (roughly 2 to 16 GB), a GPU is recommended but not required.

Licensed under MIT, which allows free use, modification, and distribution, including commercially, as long as you keep the license notice.

So what is it?

Aphelion is a desktop application that runs an AI language model entirely on your own computer, with no account, cloud service, or internet connection required after the initial setup. It works on Windows, macOS on Apple Silicon, and Linux, and once a model is downloaded the app can keep working with the internet completely disconnected. The name refers to the point in an orbit farthest from the sun, meant to suggest an AI as far as possible from the cloud. Inside the app, people can chat with characters for roleplay, write stories, build branching dialogue trees, or talk to an assistant tuned for tasks like coding help or describing images. It can also read a folder of PDFs or notes you point it at and answer questions based on that material, without those files ever leaving your machine. Beyond chat, it can generate finished documents such as PDFs with tables and formatting, or code, HTML, and Markdown files saved directly into your folders, and it can open and edit existing files too. The README is careful to explain that Aphelion is not an autonomous agent. The AI model only reads text you give it and writes text back. It cannot run programs or commands, browse the internet on its own, control your computer, or touch any file or folder unless you specifically grant access to it. The app itself handles reading files you approve and saving documents you request, but there is no ongoing loop where the AI decides to take actions by itself, and its local server only listens on your own machine. Installing it is meant to be simple: download the installer for your operating system from the releases page, run it, and on first launch the app examines your hardware and downloads an AI model sized to fit it, usually a few gigabytes. A graphics card with more video memory allows a larger, more capable model, though the app can also pick something smaller for weaker hardware. The project is released under the MIT license and macOS and Linux support is newer and less tested than the Windows version.

Copy-paste prompts

Prompt 1
Walk me through downloading and installing Aphelion for my operating system.
Prompt 2
Explain why Aphelion is described as safe by design compared to autonomous AI agents.
Prompt 3
Help me point Aphelion at a folder of notes so it can answer questions from them.
Prompt 4
What hardware do I need to run a larger, more capable model in Aphelion?

Frequently asked questions

What is aphelion?

A free desktop app that runs an AI model entirely offline on your PC for chat, roleplay, story writing, and document generation.

What language is aphelion written in?

Mainly TypeScript. The stack also includes Tauri, llama.cpp, TypeScript.

What license does aphelion use?

Licensed under MIT, which allows free use, modification, and distribution, including commercially, as long as you keep the license notice.

How hard is aphelion to set up?

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

Who is aphelion for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.