Support

support-banner support-banner

Support

Setup guides and support notes for the tools and workflows used across Midori AI projects.

Subsections of Support

Docker Setup

docker-setup-banner docker-setup-banner

Docker Setup

​

Docker Setup

# Install Docker!
# Remove `--dry-run` if your ready to install.
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh --dry-run

# Setup the docker user
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

# Test it out (standard)!
docker run --rm hello-world

# Test it out (Pixelarch!)
docker run --rm lunamidori5/pixelarch:emerald /bin/bash -lc 'echo hello world'

Docker Setup

On RPM based distributions, such as CentOS, Fedora or RHEL, you need to start it manually using the appropriate systemctl or service command. As the message indicates, non-root users can’t run Docker commands by default, but we will set it up so non root users can use it..

# Setup
sudo dnf install dnf-plugins-core

# on Fedora 40
sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo

# on Fedora 41 and newer
sudo dnf config-manager addrepo --from-repofile="https://download.docker.com/linux/fedora/docker-ce.repo"

# Install the docker packages
sudo dnf install docker-ce docker-ce-cli containerd.io

# Setup the docker user
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

# Start the docker socket
sudo systemctl enable docker
sudo systemctl start docker

# Test it out (standard)!
docker run --rm hello-world

# Test it out (Pixelarch!)
docker run --rm lunamidori5/pixelarch:emerald /bin/bash -lc 'echo hello world'

Use your package manager, yay, paru, pacman, what ever you have installed. We are going to be showing with yay, but its the same for all of them.

# Install Docker!
yay -Syu --noconfirm docker docker-compose && yay -Yccc --noconfirm

# Setup the docker user
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

# Go read the docker setup page on using systemd or init or whatever
echo "Stop by https://wiki.archlinux.org/title/Docker"

# Test it out (standard)!
docker run --rm hello-world

# Test it out (Pixelarch!)
docker run --rm lunamidori5/pixelarch:emerald /bin/bash -lc 'echo hello world'
# TODO: install docker
# TODO: start/enable the docker service
# TODO: verify with: docker run --rm hello-world
# TODO: install Docker Desktop
# TODO: (Apple Silicon) install Rosetta if you need x86_64 tooling:
# softwareupdate --install-rosetta --agree-to-license
# TODO: verify with: docker run --rm hello-world

UV (Python)

uv-banner uv-banner

UV (Python)

​
# TODO: install uv (recommended method)
# TODO: verify with: uv --version
# TODO: install uv (recommended method)
# TODO: verify with: uv --version
# TODO: install uv (recommended method)
# TODO: verify with: uv --version
# TODO: install uv (recommended method)
# TODO: verify with: uv --version
# TODO: install uv (recommended method)
# TODO: verify with: uv --version

Common Commands

# TODO: create/sync a project environment
# uv venv
# uv sync

# TODO: run a project entrypoint
# uv run <command>

# TODO: add a dependency
# uv add <package>