hermes

command module
v0.0.0-...-5ef3027 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 4, 2026 License: MIT Imports: 1 Imported by: 0

README

Hermes

GitHub Actions Workflow Status

Hermes is a tool to own your data. It can parse exported data from different sources and collect them in a JSON, Obsidian flavoured markdown, or SQLite/remote Datasette format on your own computer.

Partially ✨Vibe coded✨ with Cursor, Claude Code and Cline

Key Features

  • Export to Markdown, JSON, and SQLite
  • Optional remote export to a Datasette instance for querying and sharing

Documentation

Comprehensive documentation is available in the docs/ directory:

Importers
Utilities

Sources

  • ✅ Imdb "Your ratings" import
    • Data enriched from OMDB
  • ✅ Letterboxd using data export
    • Data enriched from OMDB
    • Automated export via hermes import letterboxd --automated (Chrome/Chromium required)
  • ✅ Goodreads
    • Data enriched from openlibrary
    • Automated export via hermes import goodreads --automated (Chrome/Chromium required)
  • ✅ Steam
    • Uses Steam API to fetch list of games you own (BYO Steam API key)
    • Game data enriched via Steam API

Commands

Enhance

Enrich existing Obsidian markdown notes with TMDB metadata:

hermes enhance --input-dirs ./markdown/movies --recursive

Or configure default enhance directories/options in config.yml and run:

hermes enhance

See docs/04_configuration.md for configuration options.

Diff

Compare imported data between sources:

# Generate markdown diff report
hermes diff imdb-letterboxd

# Generate HTML report
hermes diff imdb-letterboxd --html diff.html

See docs/08_diff.md for details.

Other

Most API data is cached locally just to be a good API citizen

  • Initial Steam import might take a while, you need to restart every few hours
  • OMDB has a 1k/day limit, so bigger lists may take a few days to fully process

Documentation

Overview

Copyright © 2024 NAME HERE <EMAIL ADDRESS>

Directories

Path Synopsis
cmd
enhance
Package enhance provides functionality to enrich existing markdown notes with TMDB data.
Package enhance provides functionality to enrich existing markdown notes with TMDB data.
internal
content
Package content provides markdown content generation from TMDB data.
Package content provides markdown content generation from TMDB data.
enrichment/book
Package book provides interfaces and utilities for enriching book metadata from multiple external sources.
Package book provides interfaces and utilities for enriching book metadata from multiple external sources.
testutil
Package testutil provides common test utilities for the hermes project.
Package testutil provides common test utilities for the hermes project.
tmdb
Package tmdb provides a client for TheMovieDB API.
Package tmdb provides a client for TheMovieDB API.
tui
Package tui provides interactive terminal UI components.
Package tui provides interactive terminal UI components.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL