pip / pipx

From Source

Install Berry directly from the GitHub repo using pip or pipx. Works on macOS, Linux, and Windows (with Python 3.10+).

Requirements

  • Python 3.10 or newer
  • pip or pipx

Install with pipx (Recommended)

pipx installs Berry in an isolated environment, avoiding dependency conflicts.

# Clone the repo
git clone https://github.com/hassana-labs/berry.git
cd berry

# Install with pipx
pipx install -e .

Install with pip

If you don't have pipx, plain pip works too:

# Clone the repo
git clone https://github.com/hassana-labs/berry.git
cd berry

# Install with pip
pip install -e .

After Installing

# Authenticate (recommended)
berry auth login
# Headless/CI: berry auth set  (or: berry auth set --stdin)

# In each repo you want to use Berry:
berry init

# Reload MCP servers in your client

Verify Installation

berry version
berry doctor

Update

cd berry
git pull
pipx install -e . --force  # or: pip install -e .

Dependencies

Berry automatically installs:

  • mcp[cli] — MCP SDK
  • openai — for verification API calls