Personal Knowledge Repository

https://github.com/ysl2/wiki
Admin
A comprehensive personal knowledge and documentation repository containing notes, configurations,...
Tokens:32,301
Snippets:368
Trust Score:8.1
Update:6 months ago
Show doc for...
Tokens:
Raw
### Setup QEMU/KVM Virtualization

Source: https://context7.com/ysl2/wiki/llms.txt

Commands to verify hardware support, install dependencies, and configure networking for KVM.

```bash
# Check virtualization support
egrep -c '(vmx|svm)' /proc/cpuinfo

# Install QEMU and virt-manager
sudo apt install qemu-kvm qemu-system qemu-utils python3 python3-pip \
    libvirt-clients libvirt-daemon-system bridge-utils virtinst \
    libvirt-daemon virt-manager -y

# Check service status
sudo systemctl status libvirtd.service

# Configure network
sudo virsh net-start default
sudo virsh net-autostart default
sudo virsh net-list --all

# Add user to required groups
sudo usermod -aG libvirt $USER
sudo usermod -aG libvirt-qemu $USER
sudo usermod -aG kvm $USER
sudo usermod -aG input $USER
sudo usermod -aG disk $USER

# Launch virt-manager
sudo virt-manager
```

--------------------------------

### Install and Start Colima

Source: https://github.com/ysl2/wiki/blob/master/colima.md

Use Homebrew to install Colima and Docker, then initialize the runtime.

```bash
brew install colima docker
colima start
# Start colima in background and enable it to start on login:
brew services start colima  # Or: `colima start --background`
```

--------------------------------

### Install and Start Colima Docker Runtime

Source: https://context7.com/ysl2/wiki/llms.txt

Installs Colima and Docker using Homebrew, starts Colima, and configures it to start automatically on login. Assumes Homebrew is installed.

```bash
brew install colima docker
colima start
brew services start colima  # Enable auto-start
```

--------------------------------

### Download and Configure CLIProxyAPI

Source: https://github.com/ysl2/wiki/blob/master/study-ai/cliproxyapi.md

Instructions for downloading the example configuration file and editing it for both Homebrew and Docker installations. For Docker, ensure log paths are created.

```bash
# For brew, install cliproxyapi first, then, edit the default config file located below.
# Check the config file path by `cliproxyapi -h`
vim $(brew --prefix)/etc/cliproxyapi.conf
```

```bash
# For docker, download config file first, then install cliproxyapi.
mkdir -p ~/.cli-proxy-api/logs
wget -O ~/.cli-proxy-api/config.yaml https://ghfast.top/https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/refs/heads/main/config.example.yaml
vim ~/.cli-proxy-api/config.yaml
```

--------------------------------

### Install and Initialize Happy CLI

Source: https://github.com/ysl2/wiki/blob/master/study-ai/happy.md

Commands to clone the repository, build the CLI, install it globally, and run initial setup commands.

```bash
git clone git@github.com:slopus/happy.git
cd happy/packages/happy-cli
yarn build
npm install -g .

happy auth
happy codex
```

--------------------------------

### Install and Enable TUN Service on Linux

Source: https://github.com/ysl2/wiki/blob/master/clash-verge-rev.md

Use these commands to install the service, reload the system daemon, and start the Clash Verge service.

```bash
sudo clash-verge-service-install
sudo systemctl daemon-reload
sudo systemctl enable --now clash-verge-service
sudo systemctl status clash-verge-service
```

--------------------------------

### Autostart X11 Script for Localhost

Source: https://github.com/ysl2/wiki/blob/master/wm-i3/Localhost-configs.md

This script is executed on X11 startup for localhost configurations. It handles display setup, wallpaper, input methods, and background services. Ensure `~/.screenlayout/main.sh` exists for display configuration and `feh` or `swaybg` is installed for wallpaper.

```bash
#!/bin/sh

# Small and big:
# xrandr --output eDP-1 --mode 1920x1080 --pos 320x1440 --rotate normal --output HDMI-1 --primary --mode 2560x1440 --pos 0x0 --rotate normal --output DP-1 --off --output HDMI-2 --off
# Small and middle:
# xrandr --output eDP-1 --mode 1920x1080 --pos 0x1024 --rotate normal --output HDMI-1 --off --output DP-1 --primary --mode 1280x1024 --pos 320x0 --rotate normal --output HDMI-2 --off
# Small and TV:
# xrandr --output eDP-1 --mode 1920x1080 --pos 0x768 --rotate normal --output HDMI-1 --primary --mode 1360x768 --pos 280x0 --rotate normal --output DP-1 --off --output HDMI-2 --off
# NOTE: New: No need for above. just run this (auto generated by arandr):
~/.screenlayout/main.sh
feh --bg-fill /usr/share/desktop-base/emerald-theme/wallpaper/contents/images/2560x1440.svg
# feh --bg-fill ~/Pictures/wallpapers/2560x1440.svg
# feh --bg-fill ~/Pictures/flowers.jpg
# swaybg -i ~/Pictures/wall.png -m fill
fcitx5 -d -r
udiskie -A -N -t &
# cfw &
# NOTE: For horizontal scrolling firefox page.
# Ref: https://askubuntu.com/a/407233
# sudo apt install xautomation xbindkeys
xbindkeys
```

--------------------------------

### Clone and Setup GPT Academic

Source: https://github.com/ysl2/wiki/blob/master/study-ai/gpt-academic.md

Clone the repository, copy configuration, initialize conda, create a virtual environment, activate it, install requirements, and run the application.

```bash
source /etc/network_turbo
git clone --depth=1 git@github.com:binary-husky/gpt_academic.git
cd gpt_academic
cp config.py config_private.py
vim config_private.py
conda init
source ~/.bashrc
conda create -n gptac_venv python=3.11
conda activate gptac_venv
python -m pip install -r requirements.txt
python main.py
```

--------------------------------

### Install cc-switch-cli

Source: https://github.com/ysl2/wiki/blob/master/study-ai/cc-switch-cli.md

Clone the repository, build the release binary, and install the executable.

```bash
cd ~/Documents
git clone git@github.com:SaladDay/cc-switch-cli.git
cd cc-switch-cli/src-tauri
cargo build --release
cp target/release/cc-switch ~/.vocal/cc-switch
```

--------------------------------

### Start Docker Compose Services

Source: https://context7.com/ysl2/wiki/llms.txt

Starts the services defined in the Docker Compose file. Ensure all previous setup steps are completed before running this command.

```bash
docker compose up -d
```

--------------------------------

### Initialize OpenClaw Configuration

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/openclaw.md

Initializes OpenClaw configuration and installs the gateway daemon. This command launches a wizard to guide through workspace, channel, and AI model setup.

```bash
openclaw onboard --install-daemon
```

--------------------------------

### Install configuration and dependencies

Source: https://github.com/ysl2/wiki/blob/master/wm-i3/!Home.md

Clones the configuration repository and installs necessary system utilities and language-specific packages.

```bash
git clone git@github.com:ysl2/i3.git ~/.config/i3

pip install autotiling
cargo install i3-autolayout
sudo apt install xdotool rofi xcwd yad

# If using anaconda, you should `conda install -c conda-forge libstdcxx-ng`
# Ref: https://stackoverflow.com/a/75333466/13379393
# Disable this due to bug.
# git clone git@github.com/ysl2/i3expod-ng.git && cd i3expod-ng && make install
```

--------------------------------

### Install System Packages

Source: https://github.com/ysl2/wiki/blob/master/os-debian/Home.md

Commands to install common utilities and drivers.

```bash
cargo install pfetch
```

```bash
sudo apt install tmux
```

```bash
sudo apt install nvidia-driver
```

```bash
sudo apt install -y xclip zathura texlive-full
```

--------------------------------

### Manage Docker Installation and Configuration

Source: https://context7.com/ysl2/wiki/llms.txt

Includes installation commands for Linux and macOS, user group management, plugin installation, registry mirror configuration, and resource cleanup.

```bash
# Installation for Linux via apt
sudo apt install -y docker.io

# Installation for macOS via Colima (recommended)
brew install colima docker
colima start

# Add user to docker group (Linux)
sudo usermod -aG docker "$USER"
logout  # and login again

# Install docker-compose plugin manually
DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
mkdir -p $DOCKER_CONFIG/cli-plugins
curl -SL "https://ghfast.top/https://github.com/docker/compose/releases/download/v2.33.0/docker-compose-$(uname -s)-$(uname -m)" -o $DOCKER_CONFIG/cli-plugins/docker-compose
chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
docker compose version

# Set Chinese mirror for Linux
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": ["https://docker.m.daocloud.io"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

# Clean docker resources
docker system prune -a --volumes

# Check host IP from within container
ip route | awk '/default/ { print $3 }'
```

--------------------------------

### Install Rust Toolchain

Source: https://github.com/ysl2/wiki/blob/master/os-mac/!Home.md

Installs Rust via Homebrew and initializes the environment.

```bash
brew install rustup
rustup-init
```

--------------------------------

### Install woff2 from source

Source: https://github.com/ysl2/wiki/blob/master/woff2.md

Clone the repository and build the binaries using make.

```bash
git clone --recursive git@github.com:google/woff2.git
cd woff2
make clean all
mv woff2_* ~/.vocal
```

--------------------------------

### Install Go from source

Source: https://github.com/ysl2/wiki/blob/master/golang.md

Downloads and extracts a specific version of Go to a local directory.

```bash
#!/bin/bash

GO_VERSION=1.24.0
PREFIX="$HOME"/.vocal

cd /tmp
wget -c https://go.dev/dl/go"$GO_VERSION".linux-amd64.tar.gz
tar xvf go"$GO_VERSION".linux-amd64.tar.gz
mv go "$PREFIX"/golang
```

--------------------------------

### Install Firefox from PPA

Source: https://github.com/ysl2/wiki/blob/master/firefox.md

Add the Mozilla PPA repository and install the Firefox package.

```bash
sudo add-apt-repository ppa:mozillateam/ppa
sudo apt update
sudo apt install firefox
```

--------------------------------

### Install cc-connect

Source: https://github.com/ysl2/wiki/blob/master/study-ai/cc-connect.md

Install the package globally and configure the daemon service. macOS users must remove the quarantine attribute after installation.

```bash
npm install -g cc-connect@beta
# NOTE: For macOS only:
xattr -d com.apple.quarantine cc-connect
# Add into auto start service:
cc-connect daemon start
```

--------------------------------

### Build and install fork version

Source: https://github.com/ysl2/wiki/blob/master/study-ai/gemini-cli.md

Clones the repository and installs the package globally from the local source.

```bash
git clone git@github.com:ysl2/gemini-cli.git -b v0.1.15
cd gemini-cli
npm run clean && npm run build && npm install -g .
```

--------------------------------

### Install and Configure Fail2ban

Source: https://context7.com/ysl2/wiki/llms.txt

Installs Fail2ban and rsyslog, copies the default configuration to a local file for customization, and provides an example diff for changing the SSH port.

```bash
sudo apt install rsyslog fail2ban
cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
sudo vim /etc/fail2ban/jail.local
```

```diff
---	jail.conf
+++	jail.local
@@ -277,7 +277,8 @@
-	port    = ssh
+	enabled = true
+	port    = 36000
 	logpath = %(sshd_log)s
 	backend = %(sshd_backend)s
```

--------------------------------

### Install opencode and oh-my-opencode

Source: https://github.com/ysl2/wiki/blob/master/study-ai/opencode.md

Use Homebrew to install the opencode CLI and the oh-my-opencode plugin.

```bash
# Install opencode
brew install anomalyco/tap/opencode

# Install oh-my-opencode
brew tap oven-sh/bun
brew install bun
bunx oh-my-opencode install
```

--------------------------------

### Setup Environment on AI Studio

Source: https://github.com/ysl2/wiki/blob/master/os-windows/!Home.md

Commands to clone repositories and initialize the environment on AI Studio platforms.

```bash
# First enter project:
cd
git clone https://gitee.com/ysl2/dotlib.git
git clone https://gitee.com/ysl2/dotfiles.git
mv dotfiles/.git dotfiles_git
ln -s dotfiles_git .git
ln -s dotlib .dotlib
~/.scripts/localbin.sh lf
~/.Local/bin/lf -config ~/.dotlib/.config/lf/lfrc  # Merge conflict files in $HOME ...
rm -rf dotfiles
source ~/.bashrc

# Restore project:
cd
ln -s dotfiles_git .git
ln -s dotlib .dotlib
git reset --hard HEAD
source ~/.bashrc
```

--------------------------------

### Install Docker on Linux via apt

Source: https://github.com/ysl2/wiki/blob/master/docker.md

Standard installation method for Debian-based Linux distributions.

```bash
sudo apt install -y docker.io
```

--------------------------------

### Download Ollama Install Script

Source: https://github.com/ysl2/wiki/blob/master/study-ai/ollama.md

Use curl to download the Ollama installation script. This is the initial step for setting up Ollama.

```bash
curl -fsSL https://ollama.com/install.sh -o ollama_install.sh
```

--------------------------------

### Install a Specific Plugin

Source: https://github.com/ysl2/wiki/blob/master/study-ai/claude-code.md

Install the 'ralph-loop' plugin from the official Claude plugins repository using the `/plugin install` command.

```bash
/plugin install ralph-loop@claude-plugins-official
```

--------------------------------

### Install CLIProxyAPI with Homebrew

Source: https://github.com/ysl2/wiki/blob/master/study-ai/cliproxyapi.md

Use this command to install the CLIProxyAPI tool via Homebrew. Ensure Homebrew is installed on your system.

```bash
brew install cliproxyapi
```

--------------------------------

### Install Miniserve with Homebrew

Source: https://github.com/ysl2/wiki/blob/master/miniserve.md

Use this command to install the miniserve application using the Homebrew package manager.

```bash
brew install miniserve
```

--------------------------------

### Initialize a new Python project with uv

Source: https://github.com/ysl2/wiki/blob/master/uv.md

Use 'uv init' to create a new project directory and set up a virtual environment with a specified Python version. Ensure the Python version is installed on your system.

```bash
uv init myproject -p 3.12
```

--------------------------------

### Add dependencies using uv

Source: https://github.com/ysl2/wiki/blob/master/uv.md

Use 'uv add' to install and record specified packages in your project's dependencies. For example, 'torch', 'torchvision', and 'rich' are added here.

```bash
uv add torch torchvision rich
```

--------------------------------

### Install Ollama

Source: https://context7.com/ysl2/wiki/llms.txt

Installs Ollama using the official installation script. This command downloads and runs the script from the provided URL.

```bash
curl -fsSL https://ollama.com/install.sh | sh
```

--------------------------------

### Install BabelDOC

Source: https://github.com/ysl2/wiki/blob/master/babeldoc.md

Install BabelDOC using the uv tool for Python 3.12. After installation, you can verify it by running the --help command.

```bash
uv tool install --python 3.12 BabelDOC
```

```bash
babeldoc --help
```

--------------------------------

### Install Fcitx5 dependencies

Source: https://github.com/ysl2/wiki/blob/master/fcitx5.md

Install the core Fcitx5 package and Chinese language support addons via apt.

```bash
sudo apt-get install fcitx5 fcitx5-chinese-addons
```

--------------------------------

### Install TeX Live on Linux

Source: https://github.com/ysl2/wiki/blob/master/texlive.md

Uses the apt package manager to install the full TeX Live distribution.

```bash
sudo apt install texlive-full
```

--------------------------------

### Install and use img2pdf

Source: https://github.com/ysl2/wiki/blob/master/!Home.md

Install the tool via pip and convert images to a PDF file.

```bash
pip install img2pdf

img2pdf *.jpg -o output.pdf
```

--------------------------------

### Install QEMU and Virt-Manager Packages

Source: https://github.com/ysl2/wiki/blob/master/qemu.md

Installs QEMU, KVM, and related utilities for managing virtual machines on Debian. This command installs packages for QEMU, Python, libvirt, and virt-manager.

```bash
sudo apt install qemu-kvm qemu-system qemu-utils python3 python3-pip libvirt-clients libvirt-daemon-system bridge-utils virtinst libvirt-daemon virt-manager -y
```

--------------------------------

### Install Tailscale

Source: https://github.com/ysl2/wiki/blob/master/tailscale.md

Installs Tailscale using a curl script. Ensure you have the necessary permissions.

```bash
curl -fsSL https://tailscale.com/install.sh | sh
```

--------------------------------

### Install ttyd from source

Source: https://github.com/ysl2/wiki/blob/master/ttyd.md

Builds and installs ttyd along with its dependencies on a Linux system.

```bash
sudo apt-get update
sudo apt-get install -y build-essential cmake git libjson-c-dev libwebsockets-dev
git clone git@github.com:ysl2/ttyd.git
cd ttyd && mkdir build && cd build
cmake ..
make && sudo make install
./ssl.sh
```

--------------------------------

### Install Docker Compose via source

Source: https://github.com/ysl2/wiki/blob/master/docker.md

Manually download and install the Docker Compose plugin into the user's Docker configuration directory.

```bash
# Ref: https://stackoverflow.com/a/79052312

DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
mkdir -p $DOCKER_CONFIG/cli-plugins
curl -SL "https://ghfast.top/https://github.com/docker/compose/releases/download/v2.33.0/docker-compose-$(uname -s)-$(uname -m)" -o $DOCKER_CONFIG/cli-plugins/docker-compose

chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose

# test the installation with:
docker compose version
```

--------------------------------

### Install OpenJDK on MacOS

Source: https://github.com/ysl2/wiki/blob/master/openjdk.md

Use Homebrew to install OpenJDK and then create a symbolic link for the JDK.

```bash
brew install openjdk
```

```bash
sudo ln -sfn $HOMEBREW_PREFIX/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk
```

--------------------------------

### Create Installation Media with dd

Source: https://github.com/ysl2/wiki/blob/master/os-debian/Home.md

Use the dd command to write an ISO image to a storage device.

```bash
sudo dd if=/path/to/debian.iso of=/dev/sdX bs=4M status=progress oflag=sync
```

--------------------------------

### Install i3 Window Manager

Source: https://context7.com/ysl2/wiki/llms.txt

Compilation instructions for i3wm and i3blocks, plus configuration for autotiling and display manager settings.

```bash
# Build i3wm from source
sudo apt install libstartup-notification0-dev libxcb-xkb-dev \
    libxcb-xinerama0-dev libxcb-randr0-dev libxcb-shape0-dev \
    libxcb-util0-dev libxcb-cursor-dev libxcb-keysyms1-dev \
    libxcb-icccm4-dev libxcb-xrm-dev libyajl-dev libev-dev libxkbcommon-x11-dev

cd ~/Documents/
git clone git@github.com:i3/i3.git
cd i3
rm -rf build
meson setup build
ninja -C build
sudo $(which ninja) -C build install
sudo mkdir -p /usr/share/xsessions
sudo ln -s /usr/local/share/xsessions/i3.desktop /usr/share/xsessions/i3.desktop

# Build i3blocks
sudo apt install automake autoconf
cd ~/Documents/
git clone git@github.com:vivien/i3blocks.git
cd i3blocks
./autogen.sh && ./configure && make && sudo make install

# Install configuration and dependencies
git clone git@github.com:ysl2/i3.git ~/.config/i3
pip install autotiling
cargo install i3-autolayout
sudo apt install xdotool rofi xcwd yad

# Disable display manager for startx boot
sudo systemctl set-default multi-user.target
# Re-enable display manager
sudo systemctl set-default graphical.target

# Fix slow nautilus in i3
systemctl --user mask xdg-desktop-portal-gnome xdg-desktop-portal-kde
killall xdg-desktop-portal xdg-desktop-portal-gnome xdg-desktop-portal-kde
```

--------------------------------

### CLIProxyAPI Configuration Example

Source: https://github.com/ysl2/wiki/blob/master/study-ai/cliproxyapi.md

An example configuration file for CLIProxyAPI. Key settings include enabling remote management, setting a secret key, and defining a proxy URL.

```yaml
remote-management:
  # Whether to allow remote (non-localhost) management access.
  # When false, only localhost can access management endpoints (a key is still required).
  # all management requests (even from localhost) require this key.
  # leave empty to disable the management api entirely (404 for all /v0/management routes).
  secret-key: "Enter your password here."

# NOTE: Proxy url is only needed for docker install. No need for brew install.
# NOTE: Proxy url is only needed for docker install. No need for brew install.
# NOTE: Proxy url is only needed for docker install. No need for brew install.
# NOTE: For macOS brew install, system-wide TUN already handles outbound traffic.
# Proxy URL. Supports socks5/http/https protocols. Example: socks5://user:pass@192.168.1.1:1080/
# Per-entry proxy-url also supports "direct" or "none" to bypass both the global proxy-url and environment proxies explicitly.
proxy-url: "http://yourname:yourpassword@127.0.0.1:7897"
```

--------------------------------

### Install VisiData with Homebrew

Source: https://github.com/ysl2/wiki/blob/master/visidata.md

Use this command to install VisiData on macOS using the Homebrew package manager.

```bash
brew install visidata
```

--------------------------------

### Install Homebrew

Source: https://github.com/ysl2/wiki/blob/master/os-mac/!Home.md

Installs the Homebrew package manager on macOS.

```bash
/bin/bash -c "$(curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

--------------------------------

### Install and run official gemini-cli

Source: https://github.com/ysl2/wiki/blob/master/study-ai/gemini-cli.md

Installs the official package via Homebrew and sets proxy environment variables for execution.

```bash
brew install gemini-cli

# Set proxy to TUN mode.
export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890
gemini-cli -m gemini-2.5-pro
```

--------------------------------

### Install Claude Code AI Assistant and Plugins

Source: https://context7.com/ysl2/wiki/llms.txt

Installs Claude Code, a command-line tool for switching CC versions, and a usage tracker using Homebrew. Includes instructions for installing plugins.

```bash
brew install --cask claude-code
brew tap farion1231/ccswitch
brew install --cask cc-switch
brew install ccusage
```

```bash
/plugin install ralph-loop@claude-plugins-official
```

--------------------------------

### Install Docker plugins via Homebrew

Source: https://github.com/ysl2/wiki/blob/master/docker.md

Installs Docker Compose and Buildx plugins using Homebrew.

```bash
brew install docker-compose
brew install docker-buildx
```

--------------------------------

### Install anylinuxfs via Homebrew

Source: https://github.com/ysl2/wiki/blob/master/os-mac/anylinuxfs.md

Use these commands to add the tap and install the package on macOS.

```bash
brew tap nohajc/anylinuxfs
brew install anylinuxfs
```

--------------------------------

### Install QQ Bot Plugin (Old Version)

Source: https://github.com/ysl2/wiki/blob/master/study-ai/openclaw.md

Install the QQ bot plugin for older versions of Openclaw and add the channel with a provided token. Restart the gateway to apply changes.

```bash
openclaw plugins install @sliverp/qqbot@latest
openclaw channels add --channel qqbot --token "xxxxxxxxxxxxxxxxxxxxxxxxxxx"
openclaw gateway restart
```

--------------------------------

### Install Package Using Proxy with Environment Variables

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/brew.md

Installs a package using Homebrew while specifying proxy settings directly in the command or by setting temporary environment variables.

```bash
http_proxy=http://127.0.0.1:20171 https_proxy=http://127.0.0.1:20171 brew install <package>
```

```bash
export http_proxy=http://127.0.0.1:20171
export https_proxy=http://127.0.0.1:20171
brew install <package>
```

--------------------------------

### Install Ollama with Systemd and Custom Storage

Source: https://context7.com/ysl2/wiki/llms.txt

Installs Ollama, sets up systemd services, and configures a custom directory for storing models. Requires root privileges for apt commands.

```bash
source /etc/network_turbo
sudo apt update
sudo apt install systemd systemctl lshw
curl -fsSL https://ollama.com/install.sh | sh
```

```bash
http_proxy=127.0.0.1:7890 https_proxy=127.0.0.1:7890 \
    OLLAMA_MODELS=/root/autodl-tmp/ollama ollama serve
```

```bash
http_proxy=127.0.0.1:7890 https_proxy=127.0.0.1:7890 \
    OLLAMA_MODELS=/root/autodl-tmp/ollama ollama run deepseek-r1:70b
```

--------------------------------

### Install TeX Live on macOS

Source: https://github.com/ysl2/wiki/blob/master/texlive.md

Uses Homebrew Cask to install the MacTeX distribution.

```bash
brew install --cask mactex
```

--------------------------------

### Configure Tailscale VPN

Source: https://context7.com/ysl2/wiki/llms.txt

Details installation, proxy configuration for restricted networks, and service startup with SSH enabled.

```bash
# Installation
curl -fsSL https://tailscale.com/install.sh | sh

# Set proxy for restricted networks
sudo mkdir -p /etc/systemd/system/tailscaled.service.d/
sudo tee /etc/systemd/system/tailscaled.service.d/override.conf > /dev/null <<EOF
[Service]
Environment="HTTP_PROXY=http://127.0.0.1:7890"
Environment="HTTPS_PROXY=http://127.0.0.1:7890"
Environment="ALL_PROXY=socks5://127.0.0.1:7890"
EOF
sudo systemctl daemon-reload
sudo systemctl restart tailscaled

# Verify proxy settings
sudo systemctl show tailscaled --property=Environment

# Start Tailscale with SSH enabled
sudo tailscale up --ssh --accept-dns=false
tailscale status
```

--------------------------------

### Configure Default Network

Source: https://github.com/ysl2/wiki/blob/master/qemu.md

Starts the default virtual network, enables it to start automatically on boot, and lists all available networks. This is crucial for VM network connectivity.

```bash
sudo virsh net-start default
sudo virsh net-autostart default
sudo virsh net-list --all
```

--------------------------------

### Install Fail2ban and Rsyslog

Source: https://github.com/ysl2/wiki/blob/master/fail2ban.md

Install the necessary packages for Fail2ban and rsyslog. Copy the default jail configuration to a local file for customization.

```bash
sudo apt install rsyslog fail2ban
cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
sudo vim /etc/fail2ban/jail.local
```

--------------------------------

### Initialize fcitx5 on Wayland

Source: https://github.com/ysl2/wiki/blob/master/wm-sway/Localhost-configs.md

Starts the fcitx5 input method framework in daemon mode with a restart command.

```bash
#!/bin/sh

fcitx5 -d -r
```

--------------------------------

### Build i3wm and i3blocks from source

Source: https://github.com/ysl2/wiki/blob/master/wm-i3/!Home.md

Commands to install build dependencies and compile i3 and i3blocks from their respective official repositories.

```bash
# Build i3wm
sudo apt install libstartup-notification0-dev libxcb-xkb-dev libxcb-xinerama0-dev libxcb-randr0-dev libxcb-shape0-dev libxcb-util0-dev libxcb-cursor-dev libxcb-keysyms1-dev libxcb-icccm4-dev libxcb-xrm-dev libyajl-dev libev-dev libxkbcommon-x11-dev
cd ~/Documents/
git clone git@github.com:i3/i3.git
cd i3
rm -rf build
meson setup build
ninja -C build
sudo $(which ninja) -C build install
sudo mkdir -p /usr/share/xsessions
sudo ln -s /usr/local/share/xsessions/i3.desktop /usr/share/xsessions/i3.desktop

# Build i3blocks
sudo apt install automake autoconf
cd ~/Documents/
git clone git@github.com:vivien/i3blocks.git
cd i3blocks
./autogen.sh
./configure
make
sudo make install
```

--------------------------------

### Install OpenSSH on macOS

Source: https://github.com/ysl2/wiki/blob/master/ssh.md

Use Homebrew to install OpenSSH and load the SSH service.

```bash
brew install openssh
sudo launchctl load -w /System/Library/LaunchDaemons/ssh.plist
```

--------------------------------

### Install cmake Binary Directly on NixOS

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/openclaw.md

Installs the cmake binary directly to bypass slow Nix downloads. It configures proxy settings, downloads and extracts cmake, and adds it to the PATH. Verify the installation with 'cmake --version'.

```bash
# Use proxy to accelerate download
export http_proxy=http://127.0.0.1:20171
export https_proxy=http://127.0.0.1:20171

# Download and extract cmake
cd ~
wget https://github.com/Kitware/CMake/releases/download/v4.1.2/cmake-4.1.2-linux-x86_64.tar.gz
tar -xzf cmake-4.1.2-linux-x86_64.tar.gz
rm cmake-4.1.2-linux-x86_64.tar.gz

# Add to PATH
echo 'export PATH=~/cmake-4.1.2-linux-x86_64/bin:$PATH' >> ~/.bashrc
export PATH=~/cmake-4.1.2-linux-x86_64/bin:$PATH

# Verify installation
cmake --version
```

--------------------------------

### Install Claude-Code and Related Tools

Source: https://github.com/ysl2/wiki/blob/master/study-ai/claude-code.md

Use Homebrew to install the Claude-Code application, cc-switch for model switching, and ccusage.

```bash
brew install --cask claude-code
brew tap farion1231/ccswitch
brew install --cask cc-switch
brew install ccusage
```

--------------------------------

### Install Docker on Linux via Homebrew

Source: https://github.com/ysl2/wiki/blob/master/docker.md

Use this command to install Docker on Linux using the Homebrew package manager.

```bash
brew install --cask docker
```

--------------------------------

### Install Draw.io and Create Symbolic Link on MacOS

Source: https://github.com/ysl2/wiki/blob/master/drawio.md

Use Homebrew to install the Draw.io cask and then create a symbolic link to the application's executable in the ~/.vocal directory for command-line access.

```bash
brew install --cask drawio
ln -s /Applications/Draw.io.app/Contents/MacOS/draw.io ~/.vocal/drawio
```

--------------------------------

### Verify Yarn Installation

Source: https://github.com/ysl2/wiki/blob/master/yarn.md

Check the currently installed Yarn version by running this command. It should output the version that was just installed, for example, 3.6.3.

```bash
yarn --version
```

--------------------------------

### Verify Homebrew Installation

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/brew.md

Reloads the shell configuration and then verifies the Homebrew installation by checking its version and prefix.

```bash
# Reload configuration
source ~/.bashrc

# Verify
brew --version
brew --prefix
```

--------------------------------

### Build and Run Alacritty from Source

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/alacritty.md

Use this snippet to build Alacritty from source. It first determines necessary libraries using Nix, then sets the RPATH using patchelf, and finally executes the compiled binary. Ensure you have Nix and patchelf installed.

```bash
LIBS=$(nix-build '<nixpkgs>' -A wayland -A libxkbcommon -A libglvnd -A fontconfig.lib -A freetype --no-out-link)
RPATH=$(echo "$LIBS" | sed 's/$/\/lib/' | tr '\n' ':')
patchelf --set-rpath "$RPATH" alacritty
./alacritty
```

--------------------------------

### Start CLIProxyAPI with Docker Compose

Source: https://github.com/ysl2/wiki/blob/master/study-ai/cliproxyapi.md

Launch the CLIProxyAPI service using Docker Compose after configuring the environment variables and docker-compose.yml. Ensure necessary paths are set.

```bash
CLI_PROXY_CONFIG_PATH="$HOME/.cli-proxy-api/config.yaml" CLI_PROXY_AUTH_PATH="$HOME/.cli-proxy-api" CLI_PROXY_LOG_PATH="$HOME/.cli-proxy-api/logs" docker compose up -d
```

--------------------------------

### Start Tailscale and Verify Status

Source: https://github.com/ysl2/wiki/blob/master/tailscale.md

Starts Tailscale with SSH enabled and DNS disabled, then checks the connection status. Requires root privileges for 'up' command.

```bash
sudo tailscale up --ssh --accept-dns=false
tailscale status
```

--------------------------------

### Install Ollama in Autodl Machine

Source: https://github.com/ysl2/wiki/blob/master/study-ai/ollama.md

Commands to set up Ollama in an autodl machine, including network configuration, system updates, and installing Ollama with a custom model path. Ensure proxies are set if needed.

```bash
source /etc/network_turbo
sudo apt update
sudo apt install systemd systemctl lshw
curl -fsSL https://ollama.com/install.sh | sh
# systemctl start ollama.service
# kill -9 [ollama process number]
http_proxy=127.0.0.1:7890 https_proxy=127.0.0.1:7890 OLLAMA_MODELS=/root/autodl-tmp/ollama ollama serve
```

```bash
http_proxy=127.0.0.1:7890 https_proxy=127.0.0.1:7890 OLLAMA_MODELS=/root/autodl-tmp/ollama ollama run deepseek-r1:70b
```

--------------------------------

### Clone LazyVim Repository (Windows Installation)

Source: https://github.com/ysl2/wiki/blob/master/lazyvim/!Home.md

This command is for cloning the LazyVim starter repository on Windows to the specified Neovim configuration path.

```bash
git clone git@github.com:ysl2/starter.git 'C:\Users\Songli Yu\AppData\Local\nvim'
```

--------------------------------

### Install gh CLI with Homebrew

Source: https://github.com/ysl2/wiki/blob/master/gh.md

Use this command to install the gh CLI tool using the Homebrew package manager.

```bash
brew install gh
```

--------------------------------

### Install Openclaw Browser Extension

Source: https://github.com/ysl2/wiki/blob/master/study-ai/openclaw.md

Install the Openclaw browser extension using the command-line interface. This command will also provide the path for manual Chrome extension loading.

```bash
openclaw browser extension install
openclaw browser extension path
```

--------------------------------

### Start OpenClaw Gateway

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/openclaw.md

Starts the OpenClaw gateway service on a specified port with verbose logging enabled. This is essential for OpenClaw's communication and message handling.

```bash
openclaw gateway --port 18789 --verbose
```

--------------------------------

### Manage Claude Plugins

Source: https://context7.com/ysl2/wiki/llms.txt

Commands to add and install plugins from the marketplace.

```bash
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
```

--------------------------------

### Clone LazyVim Repository (Common Installation)

Source: https://github.com/ysl2/wiki/blob/master/lazyvim/!Home.md

Use this command to clone the LazyVim repository to the standard Neovim configuration directory. Ensure xclip is installed for clipboard support and rustup for blink.cmp.

```bash
git clone git@github.com/ysl2/lazyvim.git ~/.config/nvim

# NOTE: Don't install xsel, it might be conflict with xclip (xclip is needed by img-clip.nvim)
# sudo apt install -y xsel  # For clipboard support
# You should install xclip instead of xsel
brew install xclip
brew install rustup; rustup toolchain install nightly  # For blink.cmp
brew install pngpaste  # For img-clip.nvim

`custom = true`: This means that the plugin is added by myself.
```

--------------------------------

### Manage CLIProxyAPI Homebrew Service

Source: https://github.com/ysl2/wiki/blob/master/study-ai/cliproxyapi.md

Commands to manage the CLIProxyAPI service when installed via Homebrew. This includes starting, stopping, restarting, and checking the service status.

```bash
# Start service and register start when login
brew services start cliproxyapi
```

```bash
# Check service status
brew services list
```

```bash
# Stop service
brew services stop cliproxyapi
```

```bash
# Restart service
brew services restart cliproxyapi
```

--------------------------------

### Basic Homebrew Package Management Commands

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/brew.md

Provides essential commands for managing packages with Homebrew, including searching, installing, listing, and uninstalling.

```bash
# Search for packages
brew search <package>

# Install packages
brew install <package>

# List installed packages
brew list

# Uninstall packages
brew uninstall <package>
```

--------------------------------

### Configure Autossh to Start on Boot

Source: https://github.com/ysl2/wiki/blob/master/autossh.md

Add the autossh command to `/etc/rc.local` to ensure the reverse tunnel starts automatically after the system reboots.

```bash
sudo vim /etc/rc.local

# Add the above code line
autossh -M 46001 -NfR 47.xxx.xxx.227:36001:localhost:22 -p 36000 gongwang@47.xxx.xxx.227
```

--------------------------------

### OpenClaw Gateway Startup Script with Proxy

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/openclaw.md

A bash script to start the OpenClaw gateway with proxy configurations required for services like Telegram in China. It sets http and https proxies and then executes the gateway command.

```bash
#!/bin/bash
export http_proxy=http://127.0.0.1:20171
export https_proxy=http://127.0.0.1:20171
exec ~/.npm-global/bin/openclaw gateway "$@"
```

--------------------------------

### Run Clash Client

Source: https://github.com/ysl2/wiki/blob/master/clash.md

Launch the Clash client with the downloaded configuration file. Specify the base directory and configuration file path.

```bash
~/.vocal/clash -d ~/.config/clash -f ~/.config/clash/main.yaml
```

--------------------------------

### Create User and Set Home Directory

Source: https://github.com/ysl2/wiki/blob/master/study-os/Linux-user-and-permission.md

Configures a new user with a specific home directory and shell. Ensure the parent directory has appropriate permissions before execution.

```bash
sudo chmod 755 /data/workspace
sudo useradd -m -d /data/workspace/songliyu -s /bin/bash songliyu
```

--------------------------------

### Install OpenClaw Globally

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/openclaw.md

Installs the latest version of OpenClaw globally using npm. Ensure cmake is in the PATH and proxy settings are configured for accelerated npm downloads. This process can take approximately 10 minutes.

```bash
# Ensure cmake is in PATH
export PATH=~/cmake-4.1.2-linux-x86_64/bin:$PATH

# Use proxy to accelerate npm download
export http_proxy=http://127.0.0.1:20171
export https_proxy=http://127.0.0.1:20171

# Install OpenClaw globally
npm install -g openclaw@latest
```

--------------------------------

### Add skills from skills.sh

Source: https://github.com/ysl2/wiki/blob/master/study-ai/skill.md

Use npx to install specific skills globally. Ensure the package names and source flags are correct for the desired skill.

```bash
# npx skills add vercel-labs/skills -s find-skills -g -y
# npx skills add vercel-labs/agent-browser -s agent-browser -g -y
npx skills add obra/superpowers -g -y
npx skills add othmanadi/planning-with-files -s planning-with-files -g -y
npx skills add anthropics/skills -s pdf -g -y
npx skills add cloudai-x/threejs-skills -g -y
```

--------------------------------

### Add TeX Live to Windows PATH

Source: https://github.com/ysl2/wiki/blob/master/texlive.md

The directory path required to be added to the system environment variables after installation.

```text
C:\texlive\2023\bin\windows
```

--------------------------------

### Synchronize project dependencies with uv

Source: https://github.com/ysl2/wiki/blob/master/uv.md

Use 'uv sync' to ensure that the project's installed dependencies match the recorded dependencies. This is useful for setting up a project on a new machine or after changes to dependency files.

```bash
uv sync
```

--------------------------------

### Configure APT for Mozilla PPA

Source: https://github.com/ysl2/wiki/blob/master/firefox.md

Set up APT preferences to prioritize the Mozilla PPA over the default Ubuntu snap repository.

```bash
echo 'Unattended-Upgrade::Allowed-Origins:: "LP-PPA-mozillateam:${distro_codename}";' | sudo tee /etc/apt/apt.conf.d/51unattended-upgrades-firefox
sudo vim /etc/apt/preferences.d/mozillateamppa
```

--------------------------------

### Verify OpenClaw Installation

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/openclaw.md

Verifies the OpenClaw installation by sourcing the bashrc file and checking the installed version. The expected output for the version is '2026.2.9'.

```bash
source ~/.bashrc
openclaw --version
```

--------------------------------

### Install Special Packages via Chocolatey

Source: https://github.com/ysl2/wiki/blob/master/os-windows/!Home.md

Installs specific software packages. Note the warnings regarding manual installation for texlive and avoiding conda.

```bash
# Don't use this to install texlive, instead, install it manually by local install.
# Ref: https://github.com/ysl2/.dotfiles/issues/34
choco install texlive --params="'/scheme:full'"
choco install ntop.portable

# Update: don't use conda, instead, use original python
# That's beacuse you might encounter the SSL problem, annoying :-<
choco install miniconda3
# Add to PATH:
# C:\tools\miniconda3
# C:\tools\miniconda3\Scripts

# Cmake
# Add to PATH: C:\Program Files\CMake\bin
```

--------------------------------

### Reinstall Dependencies

Source: https://github.com/ysl2/wiki/blob/master/yarn.md

After setting the Yarn version, run this command to ensure all project dependencies are installed correctly with the new Yarn version.

```bash
yarn install
```

--------------------------------

### Install Zathura with PDF Support on macOS

Source: https://github.com/ysl2/wiki/blob/master/zathura.md

Installs Zathura and the mupdf backend on macOS using Homebrew. Ensure you have Homebrew installed and tap the necessary repository.

```bash
# For zathura in vimtex
# Ref: https://github.com/zegervdv/homebrew-zathura?tab=readme-ov-file#osx_native_integration
brew tap homebrew-zathura/zathura
brew install zathura --with-synctex
# brew install zathura-pdf-mupdf
# d=$(brew --prefix zathura)/lib/zathura ; mkdir -p $d ; for n in cb djvu pdf-mupdf pdf-poppler ps ; do p=$(brew --prefix zathura-$n)/lib$n.dylib ; [[ -f $p ]] && ln -s $p $d ; done
brew install zathura-pdf-mupdf
mkdir -p $(brew --prefix zathura)/lib/zathura
ln -s $(brew --prefix zathura-pdf-mupdf)/libpdf-mupdf.dylib $(brew --prefix zathura)/lib/zathura/libpdf-mupdf.dylib
```

--------------------------------

### Initial Lobe Chat Deployment

Source: https://context7.com/ysl2/wiki/llms.txt

Clone the Lobe Chat repository, navigate to the Docker Compose local directory, and run the setup script. You will be prompted to select a port mode and enter your public IP address.

```bash
git clone git@github.com:ysl2/lobe-chat.git
cd lobe-chat/docker-compose/local
bash setup.sh
```

--------------------------------

### Initialize anylinuxfs

Source: https://github.com/ysl2/wiki/blob/master/os-mac/anylinuxfs.md

Run this command once to initialize the environment.

```bash
anylinuxfs init
```

--------------------------------

### Run Ollama with Chinese Mirror

Source: https://github.com/ysl2/wiki/blob/master/study-ai/ollama.md

Execute Ollama to run a model, using specified HTTP/HTTPS proxies. This command assumes the installation and mirror configuration are complete.

```bash
http_proxy=127.0.0.1:7890 https_proxy=127.0.0.1:7890 ollama run deepseek-r1:32b
```

--------------------------------

### Configure Fail2ban Jail Settings

Source: https://github.com/ysl2/wiki/blob/master/fail2ban.md

Modify the jail.local file to enable specific jails, set ports, and define log paths. This example shows enabling a jail and setting a custom port.

```diff
--- jail.conf   2022-11-09 23:46:15.000000000 +0800
+++ jail.local  2025-07-14 11:14:57.161447157 +0800
@@ -277,7 +277,8 @@
 # normal (default), ddos, extra or aggressive (combines all).
 # See "tests/files/logs/sshd" or "filter.d/sshd.conf" for usage example and details.
 #mode   = normal
-port    = ssh
+enabled = true
+port    = 36000
 logpath = %(sshd_log)s
 backend = %(sshd_backend)s
```

--------------------------------

### Configure npm User Directory on NixOS

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/openclaw.md

Ensures npm packages are installed to a user directory on NixOS due to the read-only nature of /nix/store. This involves creating a directory, exporting NPM_CONFIG_PREFIX, and adding the bin directory to the PATH.

```bash
mkdir -p ~/.npm-global
echo 'export NPM_CONFIG_PREFIX=~/.npm-global' >> ~/.bashrc
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
export PATH=~/.npm-global/bin:$PATH
```

--------------------------------

### Format and Mount a New Disk

Source: https://github.com/ysl2/wiki/blob/master/study-os/Linux-disk-and-partition.md

Use these commands to partition a new block device, format it with ext4, and configure it for automatic mounting at boot.

```bash
sudo lsblk  # List block devices and find your empty device.
sudo fdisk /dev/sdb  # Replace to your device, e.g, /dev/sda.

# In the fdisk's interactive interface, press these keys (each followed by `Enter`):
n  # New partition
p  # Primary partition
1  # Partition number (1)
   # Default first sector (press Enter)
   # Default last sector (press Enter)
w  # Write changes and exit

sudo lsblk  # Verify the new partition is created.
sudo mkfs.ext4 /dev/sda1  # Replace to your partition, e.g, /dev/sda1

# Mount the partition for testing.
sudo mkdir /mnt/nas
sudo chmod 777 /mnt
sudo chmod 777 /mnt/nas
sudo mount /dev/sda1 /mnt/nas

# Mount the partition automatically on boot.
sudo blkid /dev/sda1  # The output will be like: /dev/sdb1: UUID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" TYPE="ext4"
sudo vim /etc/fstab
# Append the following line to /etc/fstab:
UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx /mnt/nas      ext4      defaults  0      2
# <device>                                <mount_point> <fs_type> <options> <dump> <pass>

sudo mount -a  # Test the fstab configuration (should not show errors).
sudo reboot  # Reboot to verify automount works.
```

--------------------------------

### Partition and Mount Linux Disks

Source: https://context7.com/ysl2/wiki/llms.txt

Steps to format a disk, create a mount point, and configure persistent mounting via /etc/fstab.

```bash
# List block devices
sudo lsblk

# Create partition with fdisk
sudo fdisk /dev/sdb
# Interactive commands:
# n - New partition
# p - Primary partition
# 1 - Partition number
# (Enter) - Default first sector
# (Enter) - Default last sector
# w - Write and exit

# Format partition
sudo mkfs.ext4 /dev/sda1

# Create mount point and mount
sudo mkdir /mnt/nas
sudo chmod 777 /mnt /mnt/nas
sudo mount /dev/sda1 /mnt/nas

# Get UUID for fstab
sudo blkid /dev/sda1

# Add to /etc/fstab for automount
UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx /mnt/nas ext4 defaults 0 2

# Test fstab configuration
sudo mount -a
sudo reboot
```

--------------------------------

### Install Zathura on Linux

Source: https://github.com/ysl2/wiki/blob/master/zathura.md

Use this command to install Zathura on Debian-based Linux distributions.

```bash
sudo apt install zathura
```

--------------------------------

### Manage display manager boot targets

Source: https://github.com/ysl2/wiki/blob/master/wm-i3/!Home.md

Commands to toggle between multi-user (CLI) and graphical targets for booting i3wm.

```bash
# Disable DM, use starx to boot i3wm.
sudo systemctl set-default multi-user.target
# Enable DM, restore to default graphical desktop.
sudo systemctl set-default graphical.target
```

--------------------------------

### Download Clash Configuration

Source: https://github.com/ysl2/wiki/blob/master/clash.md

Use wget or curl to download your subscription link. Ensure you set the correct User-Agent header.

```bash
# Use wget:
wget --user-agent="Clash/1.18.0" -O main.yaml "Your subscription link here"
# Or, use curl:
curl -A "Clash/1.18.0" -o main.yaml "Your subscription link here"
```

--------------------------------

### Create Standard Directory Structure for Homebrew

Source: https://github.com/ysl2/wiki/blob/master/os-nixos/brew.md

Creates the necessary directory structure and symbolic links for Homebrew on NixOS, ensuring correct ownership.

```bash
# Create /home/linuxbrew directory
sudo mkdir -p /home/linuxbrew
sudo chown $USER:users /home/linuxbrew

# Create symbolic link
ln -s /home/$USER/.linuxbrew /home/linuxbrew/.linuxbrew
```
Tokens:
Raw