> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc-redirect-agent-platform-overview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

> Use Bitbucket with Agno Agents.

Enable Agno agents to interact with Bitbucket repositories, pull requests, and commits.

## Prerequisites

1. Generate an App Password:
   * Go to "Personal Bitbucket settings" -> "App passwords"
   * Create a new App password with the appropriate permissions

2. Set environment variables:
   * BITBUCKET\_USERNAME: Your Bitbucket username
   * BITBUCKET\_PASSWORD: Your generated App password

```python theme={null}

from agno.agent import Agent
from agno.tools.bitbucket import BitbucketTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

repo_slug = "ai"
workspace = "MaximMFP"

agent = Agent(
    tools=[BitbucketTools(workspace=workspace, repo_slug=repo_slug)],
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    agent.print_response("List open pull requests", markdown=True)

    # Example 1: Get specific pull request details
    # agent.print_response("Get details of pull request #23", markdown=True)

    # Example 2: Get the repo details
    # agent.print_response("Get details of the repository", markdown=True)

    # Example 3: List repositories
    # agent.print_response("List 5 repositories for this workspace", markdown=True)

    # Example 4: List commits
    # agent.print_response("List the last 20 commits", markdown=True)
```

## Run the Example

```bash theme={null}
# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno/cookbook/91_tools

# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate

python bitbucket_tools.py
```

For details, see [Bitbucket cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/bitbucket_tools.py).