REST APIs for IP geolocation, platform statistics, and binary service documentation. Every endpoint returns JSON and supports CORS for browser apps.
Welcome to the Kodachi API documentation. All endpoints return JSON data and support CORS for browser-based applications. Click any card to open the API endpoint directly in your browser.
Usage: Use curl, wget, or fetch directly from your applications.
Warning: If you misuse the API, your IP address including server IP will be blocked from the Kodachi network.
Get your public IP address and detailed geolocation data in various formats.
Returns your IPv4 address in plain text or structured formats. Perfect for scripts and automation.
Returns your IPv6 address in plain text or structured formats. Ideal for IPv6 connectivity testing.
Requires IPv6 enabled on your device/network
Advanced IP lookup with detailed geolocation, ISP info, and network data. Supports single or batch lookups.
Real-time platform statistics and system information for Kodachi infrastructure.
Real-time platform statistics including active sessions, user counts by type, VPS nodes, access cards, and daily metrics.
Version manifest for all Kodachi distributions with download URLs, SHA256 checksums, system requirements, and build metadata.
Complete CLI documentation for Kodachi Rust binary services. Each JSON file contains commands, options, examples, and system requirements.
Dependency checking and verification service for system packages and libraries.
View JSON DocumentationDNS leak detection and prevention with comprehensive testing capabilities.
View JSON DocumentationDNS server management and switching with category-based provider selection.
View JSON DocumentationGlobal application launcher for system-wide command execution.
View JSON DocumentationSystem health monitoring, emergency controls, kill switches, and panic mode operations.
View JSON DocumentationFile signature and system integrity verification service.
View JSON DocumentationIP geolocation with multi-provider fallback and Tor integration.
View JSON DocumentationCentralized logging service for all Kodachi components.
View JSON DocumentationSecure authentication services with session management and API key validation.
View JSON DocumentationOnline information management and switching service.
View JSON DocumentationFile system permission monitoring and management service.
View JSON DocumentationNetwork routing control for direct, VPN, and Tor routing modes.
View JSON DocumentationTor network management with multi-instance support and exit node rotation.
View JSON DocumentationWorkflow automation manager for batch command execution with conditional logic.
View JSON DocumentationHost-security telemetry engine: FIM, SUID drift, LD_PRELOAD and kernel-taint detection with MITRE ATT&CK annotations and a 0-100 posture score.
View JSON DocumentationUnified Rust gateway behind the desktop Conky panels; collects IP, VPN, Tor, DNS, and security-score data into one atomic, flicker-free snapshot.
View JSON DocumentationRegisters global emergency keyboard shortcuts in X11 with raw /dev/input corroboration to block XTEST injection; triggers LUKS wipe, nuke, or lockdown.
View JSON DocumentationTranslates plain-English queries into Kodachi commands via a 6-tier engine (TF-IDF, ONNX, local GGUF, Ollama, LLM, Claude CLI) with voice and REPL modes.
View JSON DocumentationManages the ML model lifecycle: downloads an ONNX model and tokenizer, trains from command metadata, supports incremental updates, and versioned snapshots.
View JSON DocumentationProcesses ai-cmd feedback corrections and applies weight adjustments to improve future predictions, with F1-score and accuracy metrics and period reports.
View JSON DocumentationMaintenance toolbox for the SQLite training database: diagnostics, backup and restore, integrity checks, VACUUM and index optimization, and schema migration.
View JSON DocumentationBackground inotify daemon that re-indexes Kodachi services when binaries are added, updated, or removed so ai-cmd always has a current command view.
View JSON DocumentationCron-based daemon that runs whitelisted Kodachi commands on a fixed schedule (dns-leak, tor-switch, health-control, integrity-check); persists across restarts.
View JSON DocumentationBackground daemon tracking VPN/Tor status, DNS leaks, file integrity, and security score; generates specific fix commands and can trigger remediation.
View JSON DocumentationMachine-facing command API for AI agents (Claude Code, GPT, Gemini): 800+ embedded commands, hybrid TF-IDF search, risk classification, and per-agent tokens.
View JSON Documentation