Mistral Vibe Setup on macOS with Isolated Python 3.12

mistral-vibe-macos-setup.txt

MISTRAL VIBE SETUP ON MACOS WITH ISOLATED PYTHON 3.12
=====================================================

NAME
    mistral-vibe-macos-setup - Install Mistral Vibe with isolated Python 3.12 on macOS

SYNOPSIS
    This guide shows how to install Mistral Vibe using an isolated Python 3.12 environment on macOS.

PREREQUISITES
    * macOS (Intel or Apple Silicon)
    * Homebrew (for mise)

INSTALLATION
    1. Install mise:
       $ curl https://mise.run | sh
       $ exec $SHELL
       $ echo "eval \"\$($HOME/.local/bin/mise activate bash)\"" >> ~/.bashrc
       $ echo "eval \"\$($HOME/.local/bin/mise activate zsh)\"" >> ~/.zshrc
       $ exec $SHELL

    2. Install Python 3.12:
       $ mise install python@3.12
       $ mise use python@3.12

    3. Create isolated virtual environment:
       $ rm -rf .venv
       $ python -m venv .venv
       $ source .venv/bin/activate
       $ python --version  # Must show 3.12.x

    4. Install Mistral Vibe:
       $ pip install mistral-vibe

CONFIGURATION
    1. Get your Mistral API key from https://mistral.ai/
    2. Set it as an environment variable:
       $ export MISTRAL_API_KEY="your_api_key_here"
       Or add it to `.venv/bin/activate` for persistence.

USAGE
    Run Mistral Vibe:
       $ vibe

TROUBLESHOOTING
    If `python --version` shows 3.9.6 after activation, use the full path:
       $ ~/.local/share/mise/installs/python/3.12.12/bin/python -m venv .venv
       $ source .venv/bin/activate
       $ pip install mistral-vibe

NOTES
    * This setup keeps your system Python untouched.
    * The virtual environment is tied to mise's Python 3.12.
    * For more details, see https://github.com/mistralai/mistral-vibe