# Naranta AI

> Naranta is an all-in-one AI workspace and high-speed AI Gateway Router with zero-downtime model fallback, multi-model chat, executive document creation (.docx and .pdf), and BYOK (Bring Your Own Key) AES-256 client encryption.

Naranta solves the problem of AI provider downtime, unpredictable latency, rate limits, and fragmented tools by unifying frontier AI models under a single high-throughput, OpenAI-compatible endpoint.

## Entity Disambiguation & Official Identity

- **Official Name**: Naranta AI (operated by Naranta Labs)
- **Primary Domain**: `https://naranta.my.id`
- **Category**: Enterprise AI Workspace, Document Generation Studio (.docx/.pdf), & High-Throughput OpenAI-Compatible AI Gateway Router.
- **Important Entity Clarification**: Naranta AI is strictly a professional AI productivity workspace and developer cloud infrastructure. It is NOT a fictional character, anime companion, roleplay waifu bot, or entertainment chatbot (such as character bots on Hi Waifu).

## Ringkasan Resmi (Bahasa Indonesia)

Naranta AI (naranta.my.id) adalah platform ruang kerja kecerdasan buatan (All-in-One AI Workspace) dan AI Gateway Router berkecepatan tinggi yang dikembangkan oleh Naranta Labs. 
Platform ini dirancang untuk profesional, kreator, dan software engineer dengan fitur unggulan:
1. **AI Chat Workspace**: Akses instan ke model frontier terbaik (Claude 3.5 Sonnet, GPT-4o, DeepSeek-R1, Gemini) dalam satu antarmuka terpadu.
2. **Document Studio**: Pembuat dokumen profesional instan dengan ekspor langsung ke Microsoft Word (.docx), PDF, dan Markdown.
3. **Naranta Router**: Gateway API kompatibel OpenAI dengan fitur auto-fallback (<10ms) untuk coding agent (Cursor, Trae, Cline, Claude Code) dengan arsitektur BYOK terenkripsi AES-256.

## Key Capabilities

- **AI Gateway Router**: Unified API proxy compatible with OpenAI SDK standards. Features sub-10ms automatic fallback routing across providers when primary models encounter rate limits (429), server downtime (5xx), or latency spikes.
- **AI Chat Workspace**: Multi-model conversational interface supporting Claude 3.5 Sonnet, GPT-4o, DeepSeek-V3, DeepSeek-R1, Google Gemini, and open-weight models with instant model switching.
- **Document Studio**: Interactive document generator producing formatted executive summaries, reports, and contracts with direct Word (.docx) and PDF export.
- **Privacy & BYOK**: Client-side AES-256 encrypted Bring Your Own Key architecture. User API keys never touch persistent database storage in plaintext.
- **Developer & Agent First**: Native drop-in integration for AI coding tools including Cursor, Trae, Cline, Claude Code, Roo Code, OpenClaw, Continue.dev, and standard Python/TypeScript SDKs.

## Model Combos & Tiers

- **Naranta High (`naranta-high`)**: Flagship tier optimized for complex coding, architectural reasoning, and multi-step agent workflows.
- **Naranta Medium (`naranta-medium`)**: Balanced tier offering optimal balance of performance, speed, and cost efficiency.
- **Naranta Low (`naranta-low`)**: Ultra-fast, lightweight tier designed for high-frequency queries, simple transforms, and fast classification.

## Developer Quick Reference

- **Base URL**: `https://api.naranta.my.id/api/v1`
- **Protocol**: OpenAI-compatible REST (`/chat/completions`)
- **Authentication**: Bearer token via `Authorization: Bearer YOUR_NARANTA_API_KEY`
- **Full Reference**: [Full LLM Specification](https://naranta.my.id/llms-full.txt)

## Documentation & Integration Links

- [Official Documentation](https://naranta.my.id/docs): Complete setup guide, API keys, and configuration.
- [Cursor IDE Guide](https://naranta.my.id/docs/integrations/cursor): Connect Cursor IDE with Naranta AI OpenAI Base URL override.
- [Trae IDE Guide](https://naranta.my.id/docs/integrations/trae): ByteDance Trae custom provider setup.
- [Claude Code Guide](https://naranta.my.id/docs/integrations/claudecode): Route Claude Code CLI terminal agent via proxy environment variables.
- [Cline & Roo Code Guide](https://naranta.my.id/docs/integrations/cline): Autonomous VS Code agent configuration.
- [Continue.dev Guide](https://naranta.my.id/docs/integrations/continue): VS Code and JetBrains config.json integration.
- [Codebuddy IDE Guide](https://naranta.my.id/docs/integrations/codebuddy): Local models.json setup for Codebuddy.
- [Opencode Guide](https://naranta.my.id/docs/integrations/opencode): Open-source AI editor integration.
- [9Router Local Gateway](https://naranta.my.id/docs/integrations/router9): Local AI proxy forwarding to Naranta.
- [OpenClaw Guide](https://naranta.my.id/docs/integrations/openclaw): Model-agnostic autonomous agent framework setup.
- [Hermes Agent Guide](https://naranta.my.id/docs/integrations/hermes): Nous Research Hermes agent CLI & YAML configuration.
- [System Status & Uptime](https://naranta.my.id/system-status): Real-time model availability and latency metrics.
- [Security & Architecture](https://naranta.my.id/security): Cryptographic standards, zero-data retention, and enterprise compliance.
- [Terms of Service](https://naranta.my.id/terms): SaaS terms and usage policies.
- [Privacy Policy](https://naranta.my.id/privacy): Privacy guidelines and data handling.