API Reference

Kodachi API Documentation

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.

IP Geolocation APIs

Get your public IP address and detailed geolocation data in various formats.

IP Check Plain (IPv4)

IPv4

Returns your IPv4 address in plain text or structured formats. Perfect for scripts and automation.

IP Check Plain (IPv6)

IPv6

Returns your IPv6 address in plain text or structured formats. Ideal for IPv6 connectivity testing.

Requires IPv6 enabled on your device/network

IP Check JSON (IPv4)

IPv4

Advanced IP lookup with detailed geolocation, ISP info, and network data. Supports single or batch lookups.

IP Check JSON (IPv6)

IPv6

Complete IPv6 geolocation data with comprehensive network analysis. Supports batch queries.

Requires IPv6 enabled on your device/network

Platform APIs

Real-time platform statistics and system information for Kodachi infrastructure.

Binary Documentation

Complete CLI documentation for Kodachi Rust binary services. Each JSON file contains commands, options, examples, and system requirements.

deps-checker

Binary

Dependency checking and verification service for system packages and libraries.

View JSON Documentation

dns-leak

Binary

DNS leak detection and prevention with comprehensive testing capabilities.

View JSON Documentation

dns-switch

Binary

DNS server management and switching with category-based provider selection.

View JSON Documentation

global-launcher

Binary

Global application launcher for system-wide command execution.

View JSON Documentation

health-control

Binary

System health monitoring, emergency controls, kill switches, and panic mode operations.

View JSON Documentation

integrity-check

Binary

File signature and system integrity verification service.

View JSON Documentation

ip-fetch

Binary

IP geolocation with multi-provider fallback and Tor integration.

View JSON Documentation

logs-hook

Binary

Centralized logging service for all Kodachi components.

View JSON Documentation

online-auth

Binary

Secure authentication services with session management and API key validation.

View JSON Documentation

online-info-switch

Binary

Online information management and switching service.

View JSON Documentation

permission-guard

Binary

File system permission monitoring and management service.

View JSON Documentation

routing-switch

Binary

Network routing control for direct, VPN, and Tor routing modes.

View JSON Documentation

tor-switch

Binary

Tor network management with multi-instance support and exit node rotation.

View JSON Documentation

workflow-manager

Binary

Workflow automation manager for batch command execution with conditional logic.

View JSON Documentation

kodachi-soc

Binary

Host-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 Documentation

conky-status

Binary

Unified Rust gateway behind the desktop Conky panels; collects IP, VPN, Tor, DNS, and security-score data into one atomic, flicker-free snapshot.

View JSON Documentation

kodachi-session-helper

Binary

Registers global emergency keyboard shortcuts in X11 with raw /dev/input corroboration to block XTEST injection; triggers LUKS wipe, nuke, or lockdown.

View JSON Documentation

ai-cmd

AI

Translates 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 Documentation

ai-trainer

AI

Manages the ML model lifecycle: downloads an ONNX model and tokenizer, trains from command metadata, supports incremental updates, and versioned snapshots.

View JSON Documentation

ai-learner

AI

Processes ai-cmd feedback corrections and applies weight adjustments to improve future predictions, with F1-score and accuracy metrics and period reports.

View JSON Documentation

ai-admin

AI

Maintenance toolbox for the SQLite training database: diagnostics, backup and restore, integrity checks, VACUUM and index optimization, and schema migration.

View JSON Documentation

ai-discovery

AI

Background 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 Documentation

ai-scheduler

AI

Cron-based daemon that runs whitelisted Kodachi commands on a fixed schedule (dns-leak, tor-switch, health-control, integrity-check); persists across restarts.

View JSON Documentation

ai-monitor

AI

Background daemon tracking VPN/Tor status, DNS leaks, file integrity, and security score; generates specific fix commands and can trigger remediation.

View JSON Documentation

ai-gateway

AI

Machine-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