Awesome
raiagent ——[ …it is possibly good ]——
<!--- FIXME: Uncomment the following preferred document title, assuming we finally crush all outstanding Travis-CI issues. raiagent —————————[ [![Build Status](https://api.travis-ci.org/leycec/raiagent.svg?branch=master)](https://travis-ci.org/leycec/raiagent) ]————————— =========== --->Welcome to raiagent
, the third-party Gentoo overlay where
Raia and gentlemanly conduct
collide.
<img src="https://cloud.githubusercontent.com/assets/217028/7741975/ce3e814a-ff55-11e4-84d9-7fe8f2fab2f0.png" width="128" height="64"/> + <img src="https://cloud.githubusercontent.com/assets/217028/7742504/0d4c7394-ff5e-11e4-9352-9a30362fb37c.png" width="64" height="96"/> = 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.<sup>1</sup>
<sup>1. We actually believe most of the specious doggerel tastelessly defibrillating that sentence.</sup>
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 hostsmangal
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.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 fromraiagent
officially hosts ZeroNet ebuilds.::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.
- 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.
- 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.
- Hatch, the increasingly popular project
management toolchain recently embraced by the Python Packaging Authority
(PyPA).
- 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.
- beartype, the un:bear:ably fast
runtime type checker guaranteeing
- 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).
- 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,
- 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 hostsmpremote
ebuilds. - rshell, a once-popular
MicroPython-specific remote shell largely superseded by
mpremote
. Nonetheless,raiagent
unofficially hostsrshell
ebuilds.
- mpremote,
MicroPython's official first-party remote controller that also
transparently supports CircuitPython.
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.
See Also
leycec
, the principal maintainer of raiagent
,
actively contributes to various other first- and third-party Gentoo overlays –
including:
- The official Qt overlay, notably the PySide2, PySide2-tools, and shiboken2 packages.
- stefan-gr's
unofficial
abendbrot
overlay, emphasizing emulation frontends (e.g., EmulationStation, RetroArch).