Skip to content

Home

Jump to bottom
Tim Post edited this page Jul 5, 2026 · 2 revisions

Welcome to the Aldous wiki!

Right now, I'm using the wiki for project coordination for anyone that wants to do something.

Sensor Development

  • For people with ideas on more dimensions to capture and how to capture them.
  • Requires knowledge of how to edit a JSON file and run a few terminal commands.
  • Requires some understanding of how semantic matching works (embeddings, similarity, distance).
  • Does NOT require knowledge of advanced code or advanced math.
  • May occasionally involve community interactions.
  • Open an issue or email <timthepost@protonmail.com> to discuss before sending a PR.

Software Development

  • More practical, small, self-contained examples of Aldous being used would be extremly helpful at this stage. (create contrib/example-name in your PR).
  • Any example CI integrations or blog posts about how you found value with it are hugely appreciated. (create contrib/your-integration in your PR).
  • Any ideas, features, feedback - y'all know how GitHub works.

Maintenance Tasks

  • We need more unencumbered works for automated variance tests. The thing is, they must:

  • Be completely out of US copyright which means published prior to January 1 1930, or produced by an entity that's exempt from protection, like official government works, AND,

  • Have an established consensus on the emotional impact of the text; it has to be famous enough to have been considered well-known then and ideally still now by people in the US and Canada, AND,

  • It should fit in the model's context window (try to stay under 6k tops, The Raven is as big as will fit), but also be ample enough to score above the noise threshold on at least a few sensor groups.

That's really darn picky, we know, but it's Copyright law. You can calibrate your model with anything you want, Aldous is never trained directly on any song lyrics, so use whatever you like when you do your own tunings. This is just for what we can include in the repo.

Community Tasks

  • Please spread the word!
  • Star on GitHub to help it be discovered.
  • Open an issue to propose any ideas (or email <timthepost@protonmail.com>)
  • Take over this wiki and documentation strategy

Clone this wiki locally