Octrafic

Open source CLI tool for automated API testing and reporting. Test your APIs by describing what you want in natural language.

If you find Octrafic useful, please ⭐ star the repo - it helps a lot!

Features

• Natural language testing - describe what you want to test in plain English; the agent generates and executes the test plan
• OpenAPI Scanner - scan your application source code to automatically generate OpenAPI 3.1 specifications
• Broad spec support - OpenAPI 3.x, Swagger 2.0, Postman Collections, GraphQL, and Markdown docs
• Multiple auth methods - Bearer token, API Key, Basic Auth, or none
• Export tests - generate Postman collections, Python pytest files, or Bash curl scripts from any test session
• PDF reports - produce professional test reports with a single command (requires weasyprint)
• Multiple LLM providers - Anthropic Claude, OpenAI, Google Gemini, OpenRouter, Ollama, llama.cpp, or any OpenAI-compatible endpoint
• Headless / CI mode - run non-interactively with octrafic test for pipeline integration

Install

Linux & macOS:

curl -fsSL https://octrafic.com/install.sh | bash

macOS (Homebrew):

brew install octrafic/tap/octrafic

Windows:

iex (iwr -useb https://octrafic.com/install.ps1)

Quick Start

octrafic

Documentation

Getting Started

• Introduction
• Installation
• Quick Start

Guides

• Chat Features
• OpenAPI Scanner
• Project Management
• Providers
• Authentication
• PDF Reports
• Exporting Tests
• Headless Mode

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE