toys

toys is an experiment to create a JSON API for exploring Guix channels on the internets.

Issue tracker is here.

The live instance can be found at toys.whereis.social. Also see other known instances, forks or alternatives.

join

If you'd like to join our channel search send a patch to ~whereiseveryone/toys@lists.sr.ht adding your channel as an entry in channels.scm.

contribute

Send patches to ~whereiseveryone/toys@lists.sr.ht

jgart and unwox can review patches and merge them.

See the good-first-issue tags if you're looking for how to get started contributing.

chat

Discussion regarding this project happens at #whereiseveryone on the Libera IRC network.

• IRC users can connect to irc.libera.chat/#whereiseveryone
• XMPP users can connect to #whereiseveryone%irc.libera.chat@irc.cheogram.com
• Matrix users can connect to #libera_#whereiseveryone:matrix.org

development

Start a development environment:

guix shell
# or even
guix shell --container --network

Initialize the database:

./dev init

Pull symbols data:

./dev pull channels.scm
# or only pull specific channel
./dev pull channels.scm CHANNEL-NAME

Run the server:

./dev serve

Visit http://localhost:8080.

other known instances, forks or alternatives

• https://search.guix.moe — [WIP] toys fork that uses xapian for the search engine instead of sqlite
• https://packages.guix.gnu.org — mainstream package search, covers official guix channel
• https://hpc.guix.info/channels — semi-official package search, covers guix, guix-hpc, guix-past and guix-science channels

hosting

Our toys instance is generously hosted by guix-hosting.com. If you are in the process of choosing your next hosting please consider them.