v1.0.4 OPERATIONAL

Swiss Watch Precision
AI Assistant

3378Γ— smaller, 12.5Γ— faster, military-grade secure. A production-grade engineering artifact built on 50+ years of experience.

14.8KB
Package Size
0.12s
Cold Start
348+
AI Models
13
Log Levels

Engineering Excellence

Most AI CLI tools are thin wrappers. ORCHAT is a production-grade artifact with military-grade precision.

πŸ€–

348+ AI Models via OpenRouter

Access GPT-4, Claude, Llama, Mistral, and every frontier model through a single unified interface. Switch models per-query with the --model flag. One tool, unlimited intelligence.

orchat --model "anthropic/claude-3-5-sonnet" "Summarize this codebase"
348+
Available Models
⚑

Real-Time Streaming

Token-by-token output with 12ms streaming latency. Pipe to any Unix tool β€” grep, sed, jq, tee.

12ms
Streaming Latency
πŸ’Ύ

O(1) Persistent History

JSON-based conversation storage with 7-day auto-cleanup, constant-time lookups, encrypted local storage.

O(1)
Lookup Time
πŸ”

Military-Grade Key Isolation

API keys never appear in history files, log files, terminal traces, or process listings. Zero exposure by architectural constraint.

  • βœ“ Never in ~/.orchat_history
  • βœ“ Never in log files (13 tiers)
  • βœ“ Never in terminal traces
  • βœ“ Never in process listings
  • βœ“ Never in Prometheus metrics
0
Key Exposure Risk
πŸ“‹

13-Level Logging Hierarchy

From QUANTUM (sub-atomic debugging) to BLACKHOLE (complete suppression). Every tier is named, intentional, and production-tested.

QUANTUM Sub-atomic debugging
TRACE Every function call
INFO Normal operations
ERROR Recoverable errors
EMERGENCY System unusable
BLACKHOLE Complete suppression
πŸ›‘οΈ

Enterprise Input Validation

8,000 character limit, 10% token safety buffer, UTF-8 BOM detection, CRLF normalization.

8K
Max Characters
☸️

Multi-Platform Distribution

Debian package, Docker image, Homebrew formula, PyPI wheel, WSL2 optimization, HuggingFace Space.

7+
Distribution Channels
πŸ“‘

Prometheus + Health Checks

Built-in metrics exporter, circuit breakers, session lifecycle hooks, exponential backoff retry logic.

9090
Metrics Port

Industry-Leading Metrics

Built for speed, efficiency, and reliability. Compare ORCHAT against industry averages.

Performance Comparison

Metric ORCHAT Industry Average Advantage
Package Size 14,792 bytes 50MB+ 3,378Γ— smaller
Cold Start 0.12 seconds 1.5+ seconds 12.5Γ— faster
Streaming Latency 12ms 150ms 12.5Γ— lower
Memory (idle) 3.2MB 50MB 15.6Γ— lighter
History Lookup O(1) O(n) Constant time

Architectural Parameters

Parameter Standard Enterprise
Max Tokens 1,000 2,000
Input Length 4,000 chars 8,000 chars
Request Timeout 30s 45s
Retry Attempts 2 5
History Length 10 turns 20 turns
Log Levels 8 13
Exit Codes 8 POSIX Full 255 range

Benchmarks

2.3s
1000-token Response
0.001s
History Lookup
95%
Validation Pass Rate

17 Modular Components

Built on 50+ years of engineering experience. Every module is sized, named, and bounded. Nothing is accidental.

Entry
orchat
β†’
Bootstrap
10KB
β†’
Validation
8K chars
β†’
OpenRouter
348+ Models
β†’
Stream
12ms
β†’
History
O(1)

Core Modules

  • β€’bootstrap.sh β€” Orchestrator
  • β€’constants.sh β€” API endpoints
  • β€’config.sh β€” Profile management
  • β€’core.sh β€” Network logic
  • β€’streaming.sh β€” Real-time chunks
  • β€’interactive.sh β€” Multi-turn REPL
  • β€’history.sh β€” JSON persistence

Enterprise Modules

  • β€’enterprise_logger.sh β€” 13 levels
  • β€’encoding.sh β€” UTF-8 BOM handling
  • β€’payload.sh β€” Request builder
  • β€’session.sh β€” Lifecycle hooks
  • β€’io.sh β€” Input/output handlers
  • β€’utils.sh β€” Helper functions
  • β€’env.sh β€” Environment detection

POSIX Exit Codes

  • βœ“E_OK=0 β€” Absolute Success
  • !E_KEY_MISSING=1 β€” API key unset
  • !E_NETWORK_FAIL=3 β€” Connectivity
  • !E_API_FAIL=4 β€” API error
  • !E_PARSE_FAIL=5 β€” JSON failure
  • !E_INVALID_INPUT=6 β€” Input violation
  • !E_DEPENDENCY=7 β€” Missing curl/jq

Validation Suite

  • βœ“Fresh install tests
  • βœ“Edge-case validation
  • βœ“Startup and memory profiling
  • βœ“Network failure scenarios
  • βœ“Prometheus metrics validation
  • βœ“19+ torture tests passed
  • βœ“FREEZE-7.5-001 certified

One-Line Installation

Choose your platform. Get started in seconds.

🐧

Debian / Ubuntu

wget -q github.com/.../orchat.deb \
&& sudo dpkg -i orchat.deb
🌐

All Linux

curl -sSL raw.githubusercontent.com/.../install.sh | bash
🍺

macOS

brew install orchat
🐳

Docker

docker run -e OPENROUTER_API_KEY="sk-or-..." ghcr.io/ariyan-pro/orchat:latest
🐍

PyPI

pip install orchat-enterprise
πŸͺŸ

Windows (WSL2)

.\setup-windows.ps1
πŸ€—

HuggingFace

Web Demo β€” No Install Required
πŸ“¦

Kubernetes

kubectl apply -f deployment/

Get Started in Seconds

# 1. Set your API key (OpenRouter)
orchat config set --api-key "sk-or-..."

# 2. Start chatting
orchat "Explain quantum computing in simple terms"

# 3. Interactive multi-turn session
orchat --interactive

# 4. Real-time streaming mode
orchat --stream "Write a Python function for binary search"

# 5. Browse 348+ available models
orchat --models

# 6. Target a specific model
orchat --model "anthropic/claude-3-5-sonnet" "Summarize this codebase"

# 7. Export conversation as JSON
orchat --export-json conversation.json

# 8. View persistent history
cat ~/.orchat_history | jq .

"Built with the precision of a Swiss watch and the reliability of 50+ years of engineering experience."

ORCHAT Enterprise CLI β€” v1.0.4 OPERATIONAL

Ready to Deploy?

Join thousands of developers using ORCHAT for production-grade AI interactions.