Table of Contents
What is gulag-web?
gulag-web is the front-facing appearance of the osu! server protocol, gulag! Using native async/await syntax written on top of Quart and cmyui's multipurpose library, gulag-web achieves flexability, cleanliness, and efficiency not seen in other frontend implementations - all while maintaining the simplicity of Python.
A primary goal of gulag-web is to keep our codebase a developer-friendly API, so that programming remains about the logic and ideas, rather than the code itself.
Varkaria and I are mainly writing this. Varkaria handles the design aspect of the frontend, making it responsive and snappy for mobile users, while I handle the backend, making sure it's easy to modify in every aspect as well as well as make it as efficent as possible.
gulag-web has come a long way, going from this, to what you see now. It's in quite the usuable state. We now have a fully implemented session authentication system allowing users to have a more interpersonal experience, leaderboards supported all mods and modes available within the gulag stack, a automated documentation system featuring markdown support, user profiles featuring every single statistic a player would need from score UR to rank graphs*, and a admin panel allowing for easy management of the gulag instance and it's users*. If you are curious on how far we have gotten, check out our projects, you can see what we have done and what we are about to complete.
* a feature that is in development or coming soon.
- Some know-how with Linux (tested on Ubuntu 18.04), Python, and general-programming knowledge.
Setup is relatively simple - these commands should set you right up.
- Ubuntu 20.04 is known to have issues with NGINX and osu! for unknown reasons?
- If you have any difficulties setting up gulag-web, feel free to join the Discord server at the top of the README, we now have a bit of a community!
# Install Python >=3.9 and latest version of PIP. sudo add-apt-repository ppa:deadsnakes/ppa sudo apt install python3.9 python3.9-dev python3.9-distutils wget https://bootstrap.pypa.io/get-pip.py python3.9 get-pip.py && rm get-pip.py # Install MySQL and NGINX. sudo apt install mysql-server nginx # Clone gulag-web from GitHub. git clone https://github.com/yo-ru/gulag-web.git cd gulag-web # Initialize and update the submodules. git submodule init && git submodule update # Install requirements from pip. python3.9 -m pip install -r ext/requirements.txt # Add and configure gulag-web's NGINX config to your nginx/sites-enabled. sudo ln -r -s ext/nginx.conf /etc/nginx/sites-enabled/gulag-web.conf sudo nano ext/nginx.conf sudo nginx -s reload # Configure gulag-web. cp ext/config.sample.py config.py nano config.py # Run gulag-web. python3.9 main.py # Run directly to access debug features for development! (Port 5000) hypercorn main.py # Please run gulag-web with hypercorn when in production! It will improve performance drastically by disabling all of the debug features a developer would need! (Port 8000)
. ├── blueprints # Modular routes such as the API, Frontend, or Admin Panel. ├── docs # Markdown files used in gulag-web's documentation system. ├── ext # External files from gulag-web's primary operation. ├── objects # Code for representing privileges, global objects, and more. ├── static # Code or content that is not modified or processed by gulag-web itself. ├── templates # HTML that contains content that is rendered after the page has loaded. ├── admin # Templated content for the admin panel (/admin). ├── settings # Templated content for settings (/settings). └ ... # Templated content for all of gulag-web (/).
Well know that you know everything, why not check out the original code gulag-web was based off of in this dusty old archived repository?