Skip to main content

CI Coverage

License

somnia

Bedtime audiobook reader with semantic seek: TTS-rendered public-domain books plus a conversational agent that finds your place again

You fall asleep to an audiobook, wake at 2am somewhere unfamiliar, and have no idea how far back the last thing you remember was. somnia renders Project Gutenberg books to audio itself — which means it knows exactly which span of audio every sentence occupies — and puts a conversation in front of that index. Say "go back to where the horse gets hurt", half asleep and in the dark, and the book goes there and plays from there. Nothing to press afterwards.

It will not tell you anything from a part of the book you have not heard yet. That bound is measured from audio that really came out of the speaker, so being carried forward does not unlock the ending.

somnia add 271                      # render + index a Gutenberg book
somnia find 271 "the horse is beaten in the street"
somnia serve                        # the page that plays it, and the agent

The page is the player: an installable PWA served over your tailnet, with a sleep timer, lock-screen controls and a rewind sized by how long the sound was off. There is no login — reachability is the authentication.

What Where
Source https://github.com/gilesknap/somnia
PyPI pip install somnia-reader — not somnia, which is somebody else's
Docker docker run ghcr.io/gilesknap/somnia:latest
Documentation https://gilesknap.github.io/somnia
Releases https://github.com/gilesknap/somnia/releases

See https://gilesknap.github.io/somnia for more detailed documentation.

Metadata

Release files for somnia-reader 0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for somnia-reader 0.7
File Size Uploaded
somnia_reader-0.7.tar.gz 1.5 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for somnia-reader 0.7
File Interpreter ABI Platform
somnia_reader-0.7-py3-none-any.whl Python 3 none any Details

Total release size: 2.3 MB

Release files / somnia_reader-0.7.tar.gz

Download URL somnia_reader-0.7.tar.gz
Size 1.5 MB
Tags Source
SHA-256 checksum
How to use checksums
f298d273138b10dd4c426f21367f5668e8defc89d0e85156d4b7308df9ff5d04
BLAKE2b-256 checksum
How to use checksums
f18ce9ec14015d97c2f3bb1a21994d67a25c1bab2b75289ca2894e32968da725
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / somnia_reader-0.7-py3-none-any.whl

Download URL somnia_reader-0.7-py3-none-any.whl
Size 799.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
daf3d9d03ff16ca87a6dc6fd7b76045b715fae08f784b3ed7384b090c711a968
BLAKE2b-256 checksum
How to use checksums
07bb48b8c3b258555e0c85b17662e4c2ad980e6e394f3ad3004d013befbfd742
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

0.7 This release

2 release files

0.6

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page