Menú
Use when deploying a Python tool from GitHub on macOS Apple Silicon.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Social media account setup guide for AI/developer platforms. Agent prepares all content (bio, avatar, posts) for user to copy-paste, since automation is blocked by Cloudflare/CAPTCHA/React shadow DOM. Supports X/Twitter, Medium, Dev.to, Reddit, LinkedIn.
Fix missing .dylib libraries when brew upgrades break Node.js browser tooling — create symlinks from old version numbers to new.
Auto-detect environment and record terminal/GUI demos for GitHub repos. Supports VHS, asciinema+agg, svg-term, and cua-driver modes. Single-command orchestration layer.
Use when releasing a new open-source project or skill pack on GitHub. Follows the proven exposure playbook from Hermes Core Skills release — covering README, community health, topics, social media, and verification. Ensures every release meets a minimum exposure bar so the project is discoverable, trustworthy, and ready for adoption.
Multi-angle GitHub project discovery using browser + GitHub API + trending, with practical clone/install/absorption workflow
Use when installing any new tool/package from GitHub, Brew, or Cask — includes post-install verification script, automated health check cron, and deliverable report so the user can independently confirm the tool is in active daily use.
| name | macos-deploy-python-tool-from-github |
| description | Use when deploying a Python tool from GitHub on macOS Apple Silicon. |
從 GitHub clone 一個 Python 開源項目，喺 macOS Apple Silicon 上完整部署並可使用。
git clone https://github.com/username/project.git ProjectName
cd ProjectName
python3 --version # 需要 Python 3.10+
pip3 --version
which git
ffmpeg -version | head -2 # 影片處理項目需要
睇 README 推薦方式，通常兩種：
# 方式 A: uv（推薦，macOS 已預裝）
uv sync --frozen
# 方式 B: pip
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
項目通常有 config.example.toml，複製一份：
cp config.example.toml config.toml
然後按 README 改 key 同 provider。
如果項目支援 Ollama 做 LLM provider：
# 確認 Ollama 已裝
ollama --version
# 確認有 model
ollama list
# config.toml 入面設定
# llm_provider = "ollama"
# ollama_base_url = "http://localhost:11434/v1" ← 注意要 /v1
# ollama_model_name = "qwen2.5:7b" ← 揀一個本地 model
uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False
或者直接：
cd ProjectName && uv run streamlit run ./webui/Main.py
Error: dyld: Library not loaded: /opt/homebrew/opt/x265/lib/libx265.215.dylib
原因：Homebrew 更新咗 x265 但 FFmpeg 冇同步更新。
Fix:
brew reinstall ffmpeg
驗證：ffmpeg -version 正常顯示就 OK。
Error: Failed to spawn: streamlit. Caused by: No such file or directory
原因：搬咗項目 folder 但 .venv 入面仲係硬編碼舊 path。
Fix（重建 venv）：
cd /new/project/path
rm -rf .venv
uv sync --frozen
Error: TomlDecodeError: Found invalid character in key name
原因：用 read_file 寫入時 embedded line number prefix。
Fix：用直接寫入方式，或者從 config.example.toml 重新複製再 patch。
cp config.example.toml config.toml
# 然後 patch 指定 key
頭一次啟動 Streamlit 會問 email，送個空 Enter 就得。
# 或者用 CLI flag skip:
--browser.gatherUsageStats=False
建立一個 .command 檔案：
cat > ~/Desktop/ProjectName.command << 'EOF'
#!/bin/bash
cd /path/to/ProjectName
uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False
EOF
chmod +x ~/Desktop/ProjectName.command
雙击就會開 Terminal 啟動。