Deterministic Infrastructure

Born in the Home Lab, Rooted in Enterprise Experience.

Eliminate the "Hallucination Gap" in infrastructure discovery. Pharos is a high-rigor, read-optimized ecosystem providing a Unified Source of Truth for humans and autonomous AI Agents. Engineering clarity for the modern enterprise.

Zero Friction Discovery

Try the Sandbox

60-Second Lab-in-a-Box
$ curl -sSL https://raw.githubusercontent.com/iamrichardD/pharos/main/deploy/sandbox.yml -o sandbox.yml && podman-compose -f sandbox.yml up -d && rm sandbox.yml
Ephemeral sandbox. Zero host pollution. Auto-wipes on teardown. Ready in 60s

Evaluated Pharos? Deploy to Production →

The Pharos Experience

A unified ecosystem designed for peak performance and absolute visibility.

Discovery

Zero-Data Entry Inventory

Stop manually typing IP addresses. pharos-scan automatically identifies SSH-enabled devices, Proxmox hosts, and Plex servers on your subnet, allowing you to inventory your entire lab in seconds.

  • Subnet-wide service fingerprinting
  • Interactive provisioning workflow
Explore Scan Documentation →
$ pharos-scan 192.168.1.0/24
Scanning subnet... [■■■■■■■■■■■■■■■■] 100%
Found 4 nodes via mDNS:
? Select nodes to provision into Pharos:
❯ [X] [NEW] 192.168.1.100 (proxmox-01) - Hypervisor
  [ ] [NEW] 192.168.1.42 (workstation) - Ubuntu Desktop
  [ ] [EXISTING] 192.168.1.1 (router) - Gateway
  [ ] [NEW] 192.168.1.105 (plex) - Media Server
--- Provisioning Node: 192.168.1.100 ---
? Alias: proxmox-01
Telemetry

Automated Inventory & Presence

Infrastructure isn't static. pharos-pulse acts as a lightweight heartbeat agent that feeds identity, presence, and hardware inventory data directly into the Pharos server.

  • Zero-configuration agent deployment
  • Integrated TUI Dashboard for lab-wide monitoring
Learn about Pulse & Telemetry →
PHAROS PULSE MONITOR Live Signals
proxmox-01
ONLINE
CPU: AMD EPYC™ 7003
OS: Proxmox VE 8.1
SN: S9Z2X844
CORES: 64 vCPU
dev-workstation
OFFLINE
CPU: Apple M2 Max
OS: macOS 14.2
SN: M124P99Q
CORES: 12 Cores
Control Plane

The webMCP Grounding Layer

The Pharos Web Console is the primary interface for Manager Success, providing a high-level orchestration layer for the entire lab. It serves as the Truth Engine for autonomous AI Agents through the webMCP protocol, enabling zero-trust asset discovery and deterministic infrastructure management.

  • webMCP Grounding Layer for Agentic Autonomy
  • Manager-focused visibility and orchestration
Explore the Web Console →
PHAROS CONSOLE
Search MDB
Query machine and infrastructure records.
Add Node
Install the Pulse agent on a new machine.
Clients

Engineer Success: Fast Access to Truth

Pharos is optimized for reducing engineering toil. ph and mdb provide ultra-fast, deterministic CLI access to people and machine records, ensuring the information you need is always exactly where you expect it.

  • Millisecond query response for rapid discovery
  • High-rigor physical attribution for infrastructure
View CLI Reference →
$ mdb find proxmox
hostname: proxmox-01
ip: 192.168.1.100
role: Hypervisor
status: ONLINE
$ ph find "richard"
name: Richard D.
title: System Architect
email: rd@example.com
ssh: registered

Deterministic Infrastructure

Pharos is a high-rigor foundation for resilient, documented, and deterministic infrastructure.

For the Home Lab Engineer

Achieve absolute visibility over your environment. Pharos eliminates manual toil, transforming your lab into a professional-grade source of truth with high-rigor physical attribution.

For the Enterprise Team

Deploy a read-optimized, deterministic directory service that integrates with existing zero-trust architecture. Secure, clinical performance at enterprise scale.

Built to Last

Hybrid Machine Database

Manage your entire inventory—from bare metal servers to virtual devices—in a single, read-optimized registry. Enable programmatic and AI Agent automation via the lightning-fast mdb CLI or the integrated WebMCP console.

Invisible High-Performance Engine

Pharos is an implementation and extension of RFC 2378 (The Phonebook Protocol), providing a proven, reliable, and lightweight backplane for modern directory services.

Read the RFC Spec →

Cross-Platform Binaries

Native performance on Linux, macOS, and Windows. Single-binary deployments with zero external dependencies.

SSH-Key Authorization

Validated against standard ~/.ssh/keys. Write operations are secure by default, leveraging your existing trust infrastructure.

AGPL-3.0 Licensed

Total freedom for the community. Ensuring that modifications to the core server are shared back for the benefit of all.

Build Your Agent-Native Infrastructure