Welcome to Halfred Documentation
Developer-focused AI infrastructure platform that simplifies access to powerful large language models through intelligent routing, prebuilt SDKs, and profile-based abstraction.

What is Halfred?
Think the precision of HAL 9000 combined with the loyalty and quiet brilliance of Alfred, Bruce Wayne's best wingman. Behind the character is a real service: an AI infrastructure layer that serves the best model for the job, with zero friction.
Halfred is not a chatbot. It's the infrastructure that handles:
Intelligent model routing: Automatically selects the best model for your use case
Multi-provider access: Connect to OpenAI, Anthropic, Google, Mistral, and more through a single API
Profile-based abstraction: Choose a profile (Lite, Standard, DeepThink) instead of managing individual models
Usage tracking: Monitor consumption and credits in real-time
Unified billing: One account, one invoice, even if requests hit multiple providers
Why Choose Halfred?
For Developers Who Want to Ship Fast
5-minute integration: Simple SDK with minimal setup
No AI expertise required: Choose a profile, we handle the rest
Drop-in OpenAI replacement: Use existing OpenAI SDK code with Halfred
Zero vendor lock-in: Switch providers seamlessly behind the scenes
Intelligent and Cost-Effective
Smart routing: Optimized for speed, quality, and cost
Resilient & reliable: No interruption—requests auto-failover to maintain service and uptime
Transparent pricing: Prepaid credit system with no hidden costs
Free development tier: Test and prototype without consuming credits
Quick Links
Getting Started
Quick Start Guide - Get up and running in 5 minutes
Authentication - How to create and manage API keys
SDK Integration
Halfred Node.js SDK - Official Node.js/TypeScript SDK
Halfred Python SDK - Official Python SDK
OpenAI SDK Compatibility - Use Halfred with OpenAI clients
Core Concepts
Model Profiles - Understanding Lite, Standard, DeepThink, and Dev profiles
Pricing & Credits - How credits and billing work
Tokens Explained - What tokens are and why they matter
API Reference
REST API Documentation - Complete REST API reference
Error Handling - Error codes and troubleshooting
Need Help?
Email: [email protected]
Discord: Join our community
Dashboard: halfred.ai
Ready to get started? Follow our Quick Start Guide to integrate Halfred in less than 5 minutes.
Last updated
