Licensed to be used in conjunction with basebox, only.
Basebox 1.7.0: The Developer-First Release
Transforming self-hosted AI into a developer-friendly powerhouse
We're excited to announce Basebox 1.7.0, our most developer-focused release yet. This update transforms Basebox into a true platform for building AI-powered applications, while maintaining the privacy, security, and control you expect from self-hosted infrastructure.
🚀 What Makes 1.7.0 Special
Basebox 1.7.0 represents a fundamental shift toward API-first development. While we've always been a powerful self-hosted AI platform, this release opens up entirely new possibilities for developers, integrators, and power users who want to build on top of Basebox.
Three key improvements define this release:
✅ OpenAI-Compatible API - Drop-in replacement for OpenAI in most tools
✅ Interactive Documentation - Test APIs directly in your browser with Swagger UI
✅ Enhanced User Experience - Better mobile support, group management, and admin tools
🔌 OpenAI-Compatible API: Your Gateway to Integration
What This Means for You
The new OpenAI-Compatible API (/v1 endpoints) makes Basebox a drop-in replacement for OpenAI's API in most scenarios. This isn't just about compatibility—it's about freedom of choice and vendor independence.
Key capabilities:
- Chat Completions (/v1/chat/completions) with streaming support
- Model Discovery (/v1/models) for dynamic application configuration
- Tool Calling with automatic vLLM endpoint handling
- Multi-tenant Authentication preserving your organization boundaries
Real-World Integration Examples
Replace OpenAI in your existing code:
# Before (OpenAI)
curl https://api.openai.com/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-d '{"model": "gpt-4", "messages": [...]}'
# After (Basebox)
curl https://your-basebox.com/v1/chat/completions \
-H "Authorization: Bearer YTIz...ZjYw" \
-d '{"model": "claude-sonnet-4", "messages": [...]}'
Integrate with popular tools:
- IDE Extensions: VS Code, Cursor, Zed Editor
- CLI Tools: OpenClaw, Goose, Continue.dev
- Custom Applications: Any tool supporting OpenAI API format
Compatibility Notes
While we support the core OpenAI API specification, we focus on the features that matter most for real-world applications:
✅ Fully Supported: - Chat completions (streaming and non-streaming) - Model listing and metadata - Message roles (user, assistant, system, tool) - Tool calling with function definitions - Temperature and token controls
⚠️ Not Supported: - Provider-specific features (like DALL-E image generation) - Some advanced OpenAI-specific parameters - Legacy completion endpoints (we use chat completions)
💡 Testing Recommended: Use our Swagger UI at /v1/api/docs to test compatibility with your specific use case before production deployment.
📖 Interactive API Documentation with Swagger UI
Test APIs Directly in Your Browser
One of the most requested features is now here: interactive API documentation. Our Swagger UI provides a complete testing environment without writing any code.
What you get: - Interactive Testing: Send real API requests directly from the documentation - Schema Exploration: Understand request/response formats with live examples - Authentication Testing: Verify your API tokens and permissions - Model Discovery: See exactly which models are available in your instance
How to Access Swagger UI
- Enable the feature in your Basebox configuration (it's optional by design)
- Navigate to
https://your-basebox.com/v1/api/docs - Authenticate using your API token
- Start testing endpoints immediately
Perfect for: - Developers validating integration approaches - DevOps teams monitoring API health and capabilities - Product teams understanding what's possible with your AI infrastructure - Support teams troubleshooting integration issues
Always Up-to-Date Documentation
Unlike static documentation, our Swagger UI is dynamically generated from your actual Basebox deployment:
- Live model list - See exactly which models are configured in your instance
- Real responses - Test with your actual models and see real output
- Accurate schemas - Documentation matches your exact API version
- Instant feedback - Catch authentication or configuration issues immediately
🛠 Enhanced Developer Experience
Message of the Day System
Administrators can now communicate important updates, maintenance windows, or feature announcements directly through the platform with our new Message of the Day system.
Features: - System-wide announcements visible to all users - Admin-configurable messaging with rich text support - Dismissible notifications that don't interrupt workflows - Multi-language support for global organizations
Operational Tooling
Server Readiness Checks: New monitoring scripts help operations teams ensure service health before directing traffic to instances.
Enhanced Audit Logging: Comprehensive audit trails with SSE streaming, configurable logging levels, and automatic partition management for compliance and debugging.
👥 Group Management and Permissions
Simplified Administration
Managing users and permissions is now much more intuitive:
Faster Group Creation:
- Press Enter to quickly create new groups
- Better error messages for duplicate names
- Live search finds users and groups instantly
- See member counts at a glance
Clearer Permissions:
- Dropdown menus for quick permission changes
- Clear labels: "Read Only" vs "Read & Write"
- Less clicking, more doing
📱 Mobile and UI Excellence
Better Mobile Experience
AI workflows increasingly happen on mobile devices, so we've made Basebox mobile-friendly:
Touch Optimizations: - Action buttons work properly on phones and tablets - Chat input scrolls correctly with mobile keyboards - Sidebar navigation adapts to small screens - App editor usable on tablets
Consistent Design: - Buttons work the same on desktop and mobile - Better error messages on small screens - Improved touch targets for easier interaction
🔒 Security and Infrastructure
Comprehensive Security Scanning
Trivy Security Integration: Automated frontend security scanning detects vulnerabilities in dependencies and provides actionable remediation guidance.
Dependency Updates: Updated critical dependencies including Keycloak (v26.5.6) and security-related packages to address latest vulnerabilities.
Authentication and Session Management
Enhanced Authentication: - Smoother user synchronization with existing accounts - Better session management and logout behavior - Clearer error messages when authentication fails - Multi-tenant support with proper organization isolation
🔧 Technical Improvements Under the Hood
Under the Hood Improvements
Cleaner Architecture: Chat completions and model handling have been refactored for better reliability and easier maintenance.
Better Provider Support:
- Improved tool calling across all AI providers
- Enhanced streaming for real-time responses
- Better error messages when things go wrong
- More reliable connections to external AI services
🛠 Real-World Integration Examples
IDE Integration with Goose
Connect Basebox to modern development workflows:
# Configure Goose to use your Basebox instance
goose config set llm.provider=openai
goose config set llm.api_base=https://your-basebox.com/v1
goose config set llm.api_key=YTIz...ZjYw
goose config set llm.model=claude-sonnet-4
OpenClaw Agent Development
Build autonomous coding agents powered by your self-hosted models:
# Add Basebox as a custom provider in OpenClaw
openclaw config set models.providers.basebox '{
"baseUrl": "https://your-basebox.com/v1",
"apiKey": "YOUR_TOKEN",
"api": "openai-completions"
}'
Custom Application Integration
Integrate Basebox into your applications with standard HTTP clients:
// Node.js example
const response = await fetch('https://your-basebox.com/v1/chat/completions', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'claude-sonnet-4',
messages: [{role: 'user', content: 'Hello!'}]
})
});
🚀 Getting Started with 1.7.0
For Developers
- Get your API token from your Basebox user profile (or ask your admin!)
- Test the connection using curl or our Swagger UI at
/v1/api/docs - Integrate with your tools using the examples in our OpenAI API User Guide
- Explore integrations with IDEs using our IDE Integration Guide
For Administrators
- Explore new admin features - Enhanced group management and Message of the Day system
- Enable Swagger UI - Allow developers to test APIs at
/v1/api/docs - Review security updates - Updated dependencies and security scanning
- Check operational tools - New readiness checks and audit logging
🔮 Looking Forward
Basebox 1.7.0 establishes the foundation for exciting future capabilities:
🔌 Ecosystem Growth - The OpenAI-compatible API opens doors to thousands of existing AI tools and libraries
🛠 Developer Experience - Interactive documentation and better tooling make building on Basebox easier than ever
🏢 Enterprise Ready - Enhanced audit logging, monitoring, and reliability features support large-scale deployments
🔄 Provider Flexibility - Improved architecture makes it easier to add new AI providers and deployment patterns
📋 Complete Feature Summary
🆕 New Features
- OpenAI-Compatible API - Drop-in replacement for most OpenAI integrations
- Swagger UI - Interactive API testing at
/v1/api/docs - Message of the Day - Admin announcements throughout the platform
- Enhanced Group Management - Faster user organization and permissions
- Mobile Optimization - Touch-friendly interface improvements
- Security Scanning - Automated vulnerability detection and updates
🔧 Bug Fixes & Improvements
- Better Error Messages - Clearer feedback when things go wrong
- Mobile Compatibility - Fixed action buttons and touch interactions
- Authentication - Smoother Keycloak integration and session handling
- Performance - Faster search, better database migrations
- Security - Updated dependencies and enhanced audit logging
🤝 Thank You
This release represents months of development focused on making Basebox more accessible, more powerful, and more reliable. We're excited to see what you'll build with these new capabilities.
Ready to explore?
- Check out the OpenAI API User Guide to get started
- Try the interactive Swagger UI at /v1/api/docs on your Basebox instance
- Integrate with your favorite development tools using our IDE Integration Guide
Questions or feedback? Your Basebox administrator can help you get started with the new features, or reach out to our support team for guidance on specific integration scenarios.
Happy building!
basebox Team
April 2026
P.S. - Want to see everything that's new? Check out our complete OpenAI API guide and IDE integration tutorials. And don't miss the Swagger UI at /v1/api/docs on your instance—it's the fastest way to understand what's possible.