whatisgithub

What is felhaven?

felsyn/felhaven — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

Felhaven is a local-first personal desktop dashboard with about 30 single-purpose modules for chat, weather, a star map, a watchlist, news feeds, and audio, all running without a server or cloud.

Mindmap

mindmap
  root((Felhaven))
    What it does
      Local desktop dashboard
      Chat with Pythia
      Voice narration
      No server or cloud
    Tech stack
      Python
      Tkinter
    Use cases
      Weather and star map
      Watchlist tracking
      News aggregation
    Design
      Single-purpose modules
      Shared infrastructure
      Encrypted key vault

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

Run a local, no-cloud personal dashboard combining chat, weather, a star map, and a news feed reader.

USE CASE 2

Track a watchlist and manual holdings ledger behind a PIN-protected local vault.

USE CASE 3

Ask questions in a home chat panel and optionally have the answers read aloud.

What is it built with?

PythonTkinter

How does it compare?

felsyn/felhaven0marildo/imago100/geotwitter
Stars333
LanguagePythonPythonPython
Last pushed2015-09-10
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencevibe codergeneralgeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Runs directly with Python, no server, database, or account setup required, though two API keys are optional.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Felhaven is a personal desktop dashboard that runs entirely on your own machine, with no database, server, or cloud service behind it. It is built on something the author calls the Metis Toolbox, a collection of about 30 small, independent modules where each one does exactly one job and does not know about the others. Felhaven displays those modules as panels in a windowed app, a component called Pythia answers questions in a home chat window, and another component called Calliope can read Pythia's answers aloud if you turn that on. Three shared pieces of infrastructure tie all the modules together without the modules depending on each other directly. One handles timing and background work so panels update on a schedule without freezing the interface. Another is a central registry of tools that Pythia can call, built automatically from the available modules, where errors are handled gracefully instead of crashing anything. A third owns the single audio output device that any module wanting to play sound goes through. The dashboard is organized into named views reached from a sidebar: a home chat view, a clock and calendar view, a settings and system-status view, a weather view, a star map view, a watchlist and holdings view protected by a PIN, a news feed reader, an audio playback view, and a utilities view with tasks, a calculator, and a unit converter. Two additional tools, a web search helper and a local Markdown note archive, are reachable only through the chat rather than through their own panel. To run it, you either double-click a batch file that starts a PIN-protected boot process, or run the main Python file directly to skip that gate. Settings like your location and units are configured through the app's settings tab, while things like RSS feeds, playlists, and a watchlist are configured by editing plain JSON files rather than code. Two optional API keys, for a financial data service and a search service, are stored in an encrypted local vault rather than in a plain environment file, every other network call uses a public, keyless endpoint, and missing keys or binaries degrade gracefully instead of crashing the app. This is a public snapshot of a larger personal project, released under the MIT license, so you can use, copy, modify, and redistribute it freely as long as you keep the copyright notice.

Copy-paste prompts

Prompt 1
Walk me through setting up Felhaven on a fresh machine using SETUP.md.
Prompt 2
Explain how Felhaven's Kairos, Pythia, and Harmonia shared infrastructure pieces work together.
Prompt 3
How do I add a new RSS feed or playlist to Felhaven's Scriptorium and Vox Array views?
Prompt 4
What happens in Felhaven if an optional API key or audio binary is missing?

Frequently asked questions

What is felhaven?

Felhaven is a local-first personal desktop dashboard with about 30 single-purpose modules for chat, weather, a star map, a watchlist, news feeds, and audio, all running without a server or cloud.

What language is felhaven written in?

Mainly Python. The stack also includes Python, Tkinter.

What license does felhaven use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is felhaven to set up?

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

Who is felhaven for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.