starbridge 0.0.86

⭐ Integrates Claude Desktop with the web, Google and Atlassian workspaces.

⭐ Starbridge

[!TIP] 📚 Online documentation - 📖 PDF Manual

[!NOTE] 🧠 This project was scaffolded using the template oe-python-template with copier.

---

Integrates Claude Desktop with the web, Google and Atlassian workspaces.

Use Cases:

1. Fast and easy to use project setup
2. Consistent update of already scaffolded projects to benefit from new and improved features.
3. Dummy CLI application and service demonstrating example usage of the generated directory structure and build pipeline

Scaffolding

Step 1: Install uv package manager and copier

if [[ "$OSTYPE" == "darwin"* ]]; then                 # Install dependencies for macOS X
  if ! command -v brew &> /dev/null; then             ## Install Homebrew if not present
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  fi
elif [[ "$OSTYPE" == "linux-gnu"* ]]; then            # Install dependencies for Linux
  sudo apt-get update -y && sudo apt-get install curl -y # Install curl
fi
if ! command -v uvx &> /dev/null; then                # Install uv package manager if not present
  curl -LsSf https://astral.sh/uv/install.sh | sh
  source $HOME/.local/bin/env
fi
uv tool install copier                                # Install copier as global tool

Step 2: Now create an empty repository on GitHubm, clone to your local machine, and change into it's directory.

Step 3: Scaffold the project

copier copy gh:helmut-hoffer-von-ankershoffen/oe-python-template .

Step 4: Setup the local environment

uv run nox -s setup_dev

Step 5: Perform initial commit and push

git add .
git commit -m "feat: Initial commit"
git push

Visit your GitHub repository and check the Actions tab. The CI workflow should fail at the SonarQube step, as this external service is not yet configured for our new repository.

Step 6: Follow the instructions to wire up external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.

Step 7: Release the first versions

./bump

Notes:

• You can remove this section post having successfully scafolded your project.
• The following sections refer to the dummy application and service provided by this template. Use them as inspiration and adapt them to your own project.

Overview

Adding Starbridge to your project as a dependency is easy.

uv add starbridge             # add dependency to your project

If you don't have uv installed follow these instructions. If you still prefer pip over the modern and fast package manager uv, you can install the library like this:

pip install starbridge        # add dependency to your project

Executing the command line interface (CLI) in an isolated Python environment is just as easy:

uvx starbridge hello-world     # prints "Hello, world! [..]"
uvx starbridge serve           # serves webservice API
uvx starbridge serve --port=4711 # serves webservice API on port 4711

Notes:

• The API is versioned, mounted at /api/v1 resp. /api/v2
• While serving the webservice API go to http://127.0.0.1:8000/api/v1/hello-world to see the respons of the hello-world operation.
• Interactive documentation is provided at http://127.0.0.1:8000/api/docs

The CLI provides extensive help:

uvx starbridge --help                # all CLI commands
uvx starbridge hello-world --help    # help for specific command
uvx starbridge echo --help
uvx starbridge openapi --help
uvx starbridge serve --help

Operational Excellence

This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:

• Various examples demonstrating usage:
  • Simple Python script
  • Streamlit web application deployed on Streamlit Community Cloud
  • Jupyter and Marimo notebook
• Complete reference documentation on Read the Docs
• Transparent test coverage including unit and E2E tests (reported on Codecov)
• Matrix tested with multiple python versions to ensure compatibility (powered by Nox)
• Compliant with modern linting and formatting standards (powered by Ruff)
• Up-to-date dependencies (monitored by Renovate and GitHub Dependabot)
• A-grade code quality in security, maintainability, and reliability with low technical debt and codesmell (verified by SonarQube)
• Additional code security checks using GitHub CodeQL
• Security Policy
• License compliant with the Open Source Initiative (OSI)
• 1-liner for installation and execution of command line interface (CLI) via uv(x) or Docker
• Setup for developing inside a devcontainer included (supports VSCode and GitHub Codespaces)

Example Prompts

• "Create a page about road cycling, focusing on Canyon bikes, in the personal confluence space of Helmut."

Setup

uvx starbridge install - that's all.

Prequisites:

• You are running Mac OS X
• You already have the uv package manager installed
• You already have Claude Desktop for Mac OS X installed
• You don't care for the imaging extra

If you need to first install homebrew and uv - and care for all extras:

if [[ "$OSTYPE" == "darwin"* ]]; then # Install dependencies for macOS X
  if ! command -v brew &> /dev/null; then # Install Homebrew if not present
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  fi
  brew install cairo
elif [[ "$OSTYPE" == "linux-gnu"* ]]; then # Install dependencies for Linux
  sudo apt-get update -y && sudo apt-get install curl libcairo2 -y
fi
if ! command -v uvx &> /dev/null; then # Install uv package manager if not present
  curl -LsSf https://astral.sh/uv/install.sh | sh
  source $HOME/.local/bin/env
fi
uvx --with "starbridge[imaging]" starbridge install # Install starbridge, including configuration and injection into Claude Desktop App

Starbridge can be run within Docker.

MCP Server

Starbridge implements the MCP Server interface, with Claude acting as an MCP client.

Resources

[TODO: Document resources exposed to Claude Desktop]

Prompts

[TODO: Document prompts exposed to Claude Desktop]

Tools

[TODO: Document tools exposed to Claude Desktop]

CLI

[TODO: Document CLI commands]

Further Reading

• The Docker manual explains how to run Starbridge within Docker.
• Check out the reference with detailed documentation of public classes and functions.
• Our release notes provide a complete log of recent improvements and changes.
• In case you want to help us improve Starbridge: The contribution guidelines explain how to setup your development environment and create pull requests.

Additional Resources

• MCP Press release
• MCP Specification and SDKs
• MCP Info to amend Claude's context

Star History