Box AI Agents Toolkit

A Python library for building AI agents for Box. This toolkit provides functionalities for authenticating with Box using OAuth and CCG, interacting with Box files and folders, managing document generation operations, and handling metadata templates.

Features

• Authentication: Authenticate with Box using OAuth or CCG
• Box API Interactions: Interact with Box files and folders
• File Upload & Download: Easily upload files to and download files from Box
• Folder Management: Create, update, delete, and list folder contents
• Search: Search for content and locate folders by name
• Document Generation (DocGen): Create and manage document generation jobs and templates
• Metadata Templates: Create and retrieve metadata templates and instances
• AI Capabilities: Ask questions and extract information from files using Box AI
• User & Group Management: Manage and search for Box users and groups
• Collaborations: Share files and folders with users and groups
• Shared Links: Create and manage shared links for files, folders, and web links
• Tasks: Create and manage tasks on files
• Web Links: Create and manage web link bookmarks

Installation

For End Users

Install the toolkit using pip:

pip install box-ai-agents-toolkit

Or using uv (faster):

uv pip install box-ai-agents-toolkit

For Contributors and Developers

1. Install uv

uv is an extremely fast Python package installer and resolver. Install it for your platform:

macOS:

brew install uv

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Windows (wget):

wget -qO- https://astral.sh/uv/install.sh | sh

2. Clone and Install

# Clone the repository
git clone https://github.com/box-community/box-ai-agents-toolkit.git
cd box-ai-agents-toolkit

# Install dependencies (recommended)
uv sync

Quick Start

Authentication

from box_ai_agents_toolkit import get_ccg_client

# Authenticate using CCG
client = get_ccg_client()

For detailed authentication options, see Authentication Documentation.

Basic File Operations

from box_ai_agents_toolkit import box_file_get_by_id, box_upload_file

# Get a file
file = box_file_get_by_id(client, file_id="12345")

# Upload a file
result = box_upload_file(client, content="Hello World", file_name="test.txt", folder_id="0")

API Reference

Complete documentation organized by Python module:

Development

Running Tests

To run the tests, use:

pytest

Linting and Code Quality

To run the linter:

ruff check

To format code:

ruff format

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any enhancements or bug fixes.

Contact

For questions or issues, open an issue on the GitHub repository.