xthulu ("ch-THOO-loo") Python asyncio community server

While xthulu is intended to be a community server with multiple avenues of interaction (e.g. terminal, browser, REST API), its primary focus is to provide a modern SSH terminal interface which pays tribute to the bulletin boards of the 1990s. Rather than leaning entirely into DOS-era nostalgia, modern character sets (UTF-8) and terminal capabilities are taken advantage of.

• 📔 Contributor guide
• 📽️ Demo video (animated GIF)

• 📊 Alpha release project board
• ✅ Feature check list

# in the project root
bin/setup

# in the data/ directory
cp config.example.toml config.toml
ssh-keygen -f ssh_host_key -t rsa -b 4096 -N ""

# in the docker/ directory
docker compose build base-image
docker compose pull --ignore-buildable

# in the project root
bin/xt db create --seed
bin/xtu db create --seed

# in the project root
bin/build-web

# in the docker/ directory
docker compose up -d

There is a guest account which demonstrates the ability for some accounts to bypass authentication.

ssh guest@localhost

There is a user account with a password for testing password authentication.

ssh user@localhost  # password is also "user"

For the time being, the web server only demonstrates simple interoperability between the REST API and static pages. It is available at https://localhost. There is a demo application that can be used for chatting with other users connected via both the web and the SSH server.

⚠️ Traefik will be using an untrusted certificate, and you will likely be presented with a warning.

The same credentials may be used here; for the guest account, any password (or a blank password) will work.