starbridge

⭐ Starbridge

[!WARNING]
This project is currently in pre-alpha phase, i.e. partly functional. Feel
free to already watch or star the repository to stay updated on its progress.

[!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.

1. Make Claude a team member: Makes Claude an informed member of your
   organisation by accessing your organization's key knowledge resources.
2. Integrate research and knowlege management: Enables your teams to
   contribute, refine, and maintain your organisation's knowledge resources
   within Claude - seamlessly integrating research and sharing knowledge.
3. Improve efficiency: Automate repetitive workflows such as generating
   Confluence pages from Google Docs.

Example Prompts

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

Setup

If you already have uv package manager and
Claude Desktop installed on your Mac:

# Installs starbridge in an isolated Python environment
# Auto-injects configuration into Claude Desktop
uvx starbridge install

If you first need to install uv:

if ! command -v brew &> /dev/null; then # Install Homebrew
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
fi
brew install uv # Install uv via Homebrew
uvx starbridge install # Install starbridge via uv

If you want to install starbridge with the imaging extra

uvx --with "starbridge[imaging]" starbridge install

You can as well
run Starbridge with 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]

Operational Excellence

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

1. Complete reference documentation
   of the CLI
   and
   of the library
   on Read the Docs
2. Transparent test coverage
   including unit and E2E tests (reported on Codecov)
3. Matrix tested with
   multiple python versions
   to ensure compatibility (powered by Nox)
4. Compliant with modern linting and formatting standards (powered by
   Ruff)
5. Up-to-date dependencies (monitored by
   Renovate and
   Dependabot)
6. A-grade code quality
   in security, maintainability, and reliability with low technical debt and
   codesmell (verified by SonarQube)
7. Additional code security checks using
   CodeQL
8. Security Policy
9. License compliant with the Open Source Initiative (OSI)
10. 1-liner for installation and execution of command line interface (CLI) via
    uv(x) or
    Docker
11. Setup for developing inside a
    devcontainer
    included (supports VSCode and GitHub Codespaces)

Further Reading

• Inspect our
  security policy
  with detailed documentation of checks, tools and principles.
• Check out the
  CLI Reference
  with detailed documentation of all CLI commands and options.
• Check out the
  Library 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.
• We gratefully acknowledge the
  open source projects
  that this project builds upon. Thank you to all these wonderful contributors!

Star History