MicroRapids API Runtime

Your OpenAPI, but executable 🚀

MicroRapids transforms OpenAPI/Swagger specifications into powerful, executable CLI tools with built-in agent automation.

Installation

npm install -g mrapids

Quick Start

# Initialize a new API from OpenAPI spec
mrapids init my-api --from-url https://api.example.com/openapi.json

# Run in agent mode for automated operations
mrapids --mode agent

# Execute API operations
mrapids my-api get-users --limit 10

Features

• 🤖 Agent Automation - Built-in AI agent for intelligent API interactions
• 📝 OpenAPI Native - Works with any OpenAPI 3.x/Swagger specification
• 🔧 Zero Config - Automatic parameter handling and authentication
• 🌍 Cross-Platform - Native binaries for Linux, macOS, and Windows
• ⚡ Fast - Written in Rust for maximum performance
• 🔒 Secure - Built-in OAuth, API key, and Bearer token support

Platform Support

| Platform | Architecture | Requirements | |----------|-------------|--------------| | Linux | x64 | GLIBC 2.28+ or musl | | macOS | x64, ARM64 | macOS 11+ | | Windows | x64 | Windows 10+ |

Commands

Initialize API

mrapids init <name> --from-url <openapi-url>
mrapids init <name> --from-file <openapi-file>

Agent Mode

mrapids --mode agent

API Operations

mrapids <api-name> <operation> [options]

Authentication

mrapids auth login <api-name>
mrapids auth logout <api-name>

Examples

GitHub API

# Initialize GitHub API
mrapids init github --from-url https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.yaml

# List repositories
mrapids github list-repos --username octocat

# Create an issue
mrapids github create-issue --owner microsoft --repo vscode --title "Bug report" --body "Description here"

OpenAI API

# Initialize OpenAI API
mrapids init openai --from-url https://raw.githubusercontent.com/openai/openai-openapi/master/openapi.yaml

# Generate text
mrapids openai create-completion --model gpt-3.5-turbo --prompt "Hello, world!"

Configuration

MicroRapids stores configuration in ~/.mrapids/:

• apis/ - Initialized API specifications
• auth/ - Authentication credentials (encrypted)
• config.toml - Global configuration

Documentation

• GitHub Repository
• Release Notes
• API Documentation

License

MIT © MicroRapid Team

Support

• Report issues: GitHub Issues
• Website: microrapid.io