raiagent ——[ …it is possibly good ]——

Welcome to raiagent, the third-party Gentoo overlay where Raia and gentlemanly conduct collide.

+ = raiagent

Installation

raiagent is installable via the post-modern eselect repository module, superseding the antiquated layman command:

Install the eselect repository module (if needed).

$ emerge --ask app-eselect/eselect-repository
$ mkdir -p /etc/portage/repos.conf

Add and synchronize this overlay.

$ eselect repository enable raiagent
$ emerge --sync raiagent

Prepare for Gentoo-based winnage.

Motivation

raiagent publishes well-documented ebuilds unabashedly biased toward technological self-empowerment.¹

^{1. We actually believe most of the specious doggerel tastelessly
defibrillating that sentence.}

CLI

Notable command-line interface (CLI) ebuilds include:

Powerline, a general-purpose CLI statusline theme with cross-application support (e.g., bash, tmux, vim, zsh). raiagent officially hosts Powerline ebuilds, co-maintained by a frequent Powerline committer.
fishman's exuberant-ctags fork, an actively maintained ctags variant with modern language support (e.g., CSS, Objective-C). raiagent unofficially hosts live ctags ebuilds in lieu of an official release.

Japan

Notable Japanese-centric ebuilds include:

mangal, a low-level terminal user interface (TUI) for finding, fetching, and locally reading Japanese manga – complete with Vi[M]-like key bindings. raiagent unofficially hosts mangal ebuilds.

P2P

Notable peer-to-peer (P2P) ebuilds include:

~~ZeroNet, a peer-to-peer web hosting network brokered with demonetized BitCoin blockchain semantics distributed over the decentralized BitTorrent protocol complete with optional Tor-based traffic anonymization. Yeah. It's pretty special. raiagent officially hosts ZeroNet ebuilds.~~ Tragically, ZeroNet is no longer actively maintained. Until someone sufficiently young and idealistic creates a well-maintained friendly fork supporting the modern Python ecosystem, we have no choice but to remove all traces of ZeroNet from ::raiagent.

Python

Notable Python ebuilds include:

Pure-Python profilers, including:
- tuna, a newer browser-based UI for visualizing files produced by deterministic Python profilers. Although comparable to SnakeViz, tuna output is more factual than SnakeViz output and thus recommended for modern profiling workflows. raiagent unofficially hosts tuna ebuilds.
Pure-Python PEP-compliant build systems, including:
- Hatch, the increasingly popular project management toolchain recently embraced by the Python Packaging Authority (PyPA). raiagent unofficially hosts Hatch ebuilds.
Pure-Python PEP-compliant runtime type checkers, including:
- beartype, the un:bear:ably fast runtime type checker guaranteeing O(1) time complexity, coauthored by the author of this overlay. Unsurprisingly, raiagent officially hosts beartype ebuilds.
- pyright, Microsoft's permissively licensed open-source static type checker. Due to its strong performance guarantees, pyright is typically the default static type-checking solution for Python in Interactive Development Environments (IDEs) as diverse as VSCode and Vim. raiagent unofficially hosts pyright ebuilds.
Bluetooth Low Energy platform Agnostic Klient (BLEAK), a popular asyncio-based Bluetooth Low Energy (BLE) framework with extensive platform-portable native support for both mobile and non-mobile app stacks. raiagent unofficially hosts BLEAK ebuilds.
The full Kivy stack, including:
- Kivy itself, a popular user interface (UI) framework with extensive platform-portable support for both desktop and mobile devices. Thanks to Portage sadly last-riting Kivy several years ago, raiagent officially hosts Kivy ebuilds.
- KivyMD, an aesthetically pleasing suite of Google Material Design (MD)-compliant Kivy widgets. raiagent officially hosts KivyMD ebuilds.
- Buildozer, Kivy's officially supported toolchain for cross-compiling self-contained executable apps. raiagent officially hosts Buildozer ebuilds and ebuilds for optional runtime dependencies of Buildozer targeting various platforms ebuilds– including:
- python-for-android, a toolchain for cross-compiling self-contained executable apps as Android APKs and Android App Bundles (AABs).
Streamlit, a popular web dashboarding framework oriented towards data science and machine learning. raiagent officially hosts Streamlit ebuilds.

(Micro|Circuit)Python

Notable MicroPython and/or CircuitPython ebuilds include:

Remote CLI-based controllers, REPLs, and shells – including:
- mpremote, MicroPython's official first-party remote controller that also transparently supports CircuitPython. raiagent unofficially hosts mpremote ebuilds.
- rshell, a once-popular MicroPython-specific remote shell largely superseded by mpremote. Nonetheless, raiagent unofficially hosts rshell ebuilds.

Retro

Notable "enthusiast" ebuilds include:

AntiMicroX, a cross-platform gamepad->{keyboard,mouse} GUI enabling gamepad support in arbitrary games lacking native gamepad support. raiagent unofficially hosts AntiMicroX ebuilds.
Munt, a cross-platform software synthesiser emulating pre-GM Roland MIDI devices (e.g., MT-32) commonly supported by MS-DOS-era games. raiagent unofficially hosts Munt ebuilds.
VGMPlay, a cross-platform audio player and converter effectively emulating all sequenced video game sound chips and hence supporting all sequenced video game music – ever. As RetroArch is to game emulation, VGMPlay is to game audio emulation. raiagent unofficially hosts VGMPlay ebuilds.

Roguelike

Notable roguelike (i.e., games featuring permanent death as a prominent mechanic) ebuilds include:

Cataclysm: Dark Days Ahead (C:DDA), a post-apocalyptic survival horror roguelike. raiagent officially hosts C:DDA ebuilds.
The Slimy Lichmummy (TSL), a classic dungeon-crawling roguelike from the Golden Age of Roguelikes (GAOR).
UnReal World (URW), a Finnish Iron-Age wilderness survival roguelike. raiagent unofficially hosts URW ebuilds.

Interactive Fiction (IF)

Notable interactive fiction (i.e., parser games featuring text-based control schemes) ebuilds include:

Gargoyle (garglk), the ultimate back- and frontend GUI supporting most (but inevitably not all) works of interactive fiction authored over the past several decades. Whereas Portage and the equally awesome interactive-fiction overlay only host Gargoyle's nearly decade-old 2011.1 release, raiagent unofficially hosts ebuilds for most modern Gargoyle releases.
Seventh Sense, David Olsen's phenomenal back- and frontend GUI for Joe and Ben Dever's Lone Wolf franchise of 80's-era high-fantasy roguelike gamebooks. raiagent unofficially hosts Seventh Sense ebuilds. USE flags include:
- data (enabled by default): automatically downloads and installs all data needed to play Lone Wolf 1—18. Thanks to Joe's voluntary relinquishment of all prior copyright to Project Aon, these gamebooks are freely (as in both beer and speech) playable... for Sommerlund and the Kai!
- editor (not enabled by default): enables Seventh Sense's in-game WYSIWG editor for modifying existing gamebooks and creating new gamebooks under the Lone Wolf system.

Science

Notable scientifical ebuilds include:

BETSE (Bio Electric Tissue Simulation Engine), a cross-platform pure-Python CLI-based finite volume simulator for 2D computational multiphysics problems in the life sciences coauthored by the author of this overlay. Needless to say, raiagent officially hosts BETSE ebuilds.
BETSEE (Bio Electric Tissue Simulation Engine Environment), a cross-platform pure-Python PySide2-based Qt 5 GUI for BETSE coauthored by the author of this overlay. Again, raiagent officially hosts BETSEE ebuilds.

Contributors

raiagent is thanks to the concerted efforts of numerous committers and issue reporters – especially:

Nikolai Aleksandrovich Pavlov (ZyX-I), whose gracious contributions to the suite of Powerline ebuilds has been immeasurably invaluable. Thanks, Nikolai. Your Sisyphean efforts will not go unremembered.

leycec / raiagent

readme