Welcome to RAPS

RAPS🌼RAPSRust CLI for Autodesk Platform Services.View in glossary (Rust🦀RustSystems programming language known for safety.View in glossary APS CLI) is a powerful command-line💻CLIText-based interface for running commands.View in glossary tool for interacting with Autodesk Platform Services☁️APSAutodesk Platform Services - cloud APIs for CAD/BIM automation.View in glossary (APS). It provides easy access to all major APS APIs including authentication, object storage, model translation⚙️Translation JobBackground process converting CAD files to viewable formats.View in glossary, data management📂Data ManagementAPS service for accessing files in ACC, BIM 360, and Fusion.View in glossary, webhooks🪝WebhooksEvent notifications sent to your application.View in glossary, design automation🤖Design AutomationRun Autodesk desktop apps in the cloud.View in glossary, and more.

Why RAPS?

• 🦀 Written in Rust — Fast, reliable, and memory-safe
• ⚡ Built for CI/CD🔁CI/CDAutomated build, test, and deployment pipelines.View in glossary — Standardized exit codes, JSON📋JSONStandard data interchange format.View in glossary/YAML📝YAMLHuman-readable configuration format.View in glossary output, non-interactive mode
• 🔐 Secure — OS keychain🔑KeychainSecure OS storage for credentials.View in glossary storage by default, automatic token🎟️TokenCredential for API authentication.View in glossary refresh, secure plugin system
• 🚀 Interactive Shell🐚Interactive ShellRAPS mode for executing commands interactively.View in glossary — TAB completion, parameter hints, command▶️CommandInstruction executed by a CLI tool.View in glossary history
• 🤖 AI-Ready — MCP🧠MCPProtocol for AI assistant tool integration.View in glossary server for AI assistant integration
• 📦 Single Binary — No dependencies, easy installation
• 🏗️ ACC🏗️ACCAutodesk's construction management platform.View in glossary Extended — Issues, RFIs, Assets, Submittals, Checklists support

Usage Modes

RAPS offers multiple ways to interact with APS — choose the mode that fits your workflow📈WorkflowAutomated process triggered by events.View in glossary:

📖 See Usage Modes for detailed comparison and setup guides.

Core Features

🔐 Authentication

• 2-legged OAuth🔐OAuthIndustry-standard authorization protocol used by APS.View in glossary (Client Credentials🤖2-legged authServer-to-server authentication without user context.View in glossary) for server-to-server operations
• 3-legged OAuth (Authorization Code👤3-legged authUser-authorized authentication with browser login.View in glossary) with browser login
• Secure token storage with automatic refresh

📦 Object Storage Service (OSS)

• Create, list, and delete buckets (multi-region support)
• Upload, download, and manage objects
• Resumable multipart uploads for large files
• Batch uploads with parallel processing

🔄 Model Derivative

• Translate CAD📐CADSoftware for creating technical drawings and 3D models.View in glossary files to various formats (SVF2🚀SVF2Current APS viewing format (improved performance).View in glossary, OBJ🎲OBJSimple 3D geometry format.View in glossary, STL🖨️STL3D printing mesh format.View in glossary, STEP🔧STEPISO standard for 3D CAD data exchange.View in glossary, etc.)
• Check translation status with polling
• Download derivatives

🏗️ Data Management

• Browse hubs, projects, folders, and items
• Create folders and manage versions
• Full BIM 360🔵BIM 360Legacy Autodesk construction platform (predecessor to ACC).View in glossary/ACC integration
• AEC GraphQL API🔌APIInterface for software components to communicate.View in glossary for faster hub🏢HubTop-level container in Data Management (company/account).View in glossary/project📁ProjectContainer for folders and files within a hub.View in glossary queries with REST🌐RESTWeb service architecture style using HTTP.View in glossary fallback

👥 Account Admin (New in v4.0)

• Bulk user management across ACC/BIM🏛️BIMIntelligent 3D model-based design for buildings.View in glossary 360 projects
• Add, remove, update roles for users at scale
• Folder permissions management
• Resumable operations with progress tracking

🔗 Custom API Calls (New in v4.5)

• Execute arbitrary HTTP🔗HTTPProtocol for web communication.View in glossary requests to any APS endpoint
• Full control over method, headers, and body
• Enables access to any APS API not yet wrapped by RAPS

📊 Portfolio Reports (New in v4.5)

• Aggregate RFI and issue summaries across all projects
• Cross-project portfolio-level analytics
• Quick health checks for construction portfolios

📋 Template Management (New in v4.5)

• Create, update, and archive project templates
• List and inspect template details
• Standardize project setup across your organization

🤖 MCP Server

• AI Assistant Integration via Model Context Protocol
• 114 tools for natural language APS operations
• Works with Claude, Cursor, and other MCP clients

Architecture

RAPS follows a microkernel architecture that separates core functionality from extended features:

• Kernel: Minimal trusted foundation (Auth, HTTP client, Configuration⚙️ConfigurationSettings controlling application behavior.View in glossary, Error handling)
• Service Crates: Independent modules for APS APIs (OSS📦OSSAPS cloud storage for files and models.View in glossary, Derivative📤DerivativeAny output generated from model translation.View in glossary, Data Management, Design Automation, ACC, Webhooks, Reality Capture)
• Application Layer: User interfaces (CLI, MCP Server, TUI) and extended features

See the Architecture Guide for detailed information.

Quick Start

# Install RAPS CLI (choose one)
curl -fsSL https://raw.githubusercontent.com/dmytro-yemelianov/raps/main/install.sh | bash  # Linux/macOS
pip install raps                          # Python (CLI binary)
npm install -g @dmytro-yemelianov/raps-cli # Node.js
brew install dmytro-yemelianov/raps/raps  # Homebrew

# Or install Python bindings for programmatic use
pip install raps-bindings

# Configure credentials
export APS_CLIENT_ID="your_client_id"
export APS_CLIENT_SECRET="your_client_secret"

# Test authentication
raps auth test

# Start using commands!
raps bucket list

Next Steps

1. Installation — Get RAPS installed on your system
2. Usage Modes — Choose how to use RAPS (CLI, Shell, Docker🐳DockerContainer platform for consistent environments.View in glossary, etc.)
3. Configuration — Set up your APS credentials
4. Authentication — Understand authentication options
5. Your First Workflow — Upload and translate a model