---
title: "Getting Started"
description: "Learn how to set up and start using XI Objects for content provenance and verification."
published: 2026-02-18T18:06:33.462653+00:00
updated: 2026-02-18T18:06:33.462653+00:00
url: https://xiobjects.com/docs/xio/getting-started
source: XI Objects
---

<!-- xion:doctype xion+markdown -->
<!-- xion:metadata
{
  "version": "1.0",
  "content_type": "application/xion\u002Bmarkdown",
  "source_type": "xi-content/doc",
  "generator": "xio-content-publisher/1.0.0",
  "generated": "2026-05-13T22:51:27.7805521\u002B00:00",
  "encoding": "utf-8",
  "render_intent": "markdown",
  "title": "Getting Started",
  "slug": "xio/getting-started",
  "copyright": "\u00A9 2026 XI Objects Inc"
}
-->

# Getting Started with XI Objects

Welcome to XI Objects! This guide will help you get started with the platform, from understanding the tooling to resolving your first `.xio` domain query.

## Prerequisites

- .NET 10.0 or later
- Access to an Orbital endpoint

## The `xi` CLI Tool

The fastest way to explore XI Objects is with the **`xi` command-line tool**, a Spectre.Console-powered TUI and CLI for interacting with the Orbital network.

### Installation

The `xi` tool is distributed as a self-contained .NET executable. Build from source:

```bash
cd src/tools/Xio.Cli
dotnet publish -c Release
```

### Configure a Connection

```bash
# Add an Orbital endpoint profile
xi config add my-orbital -e https://orbital.example.com

# Set it as active
xi config use my-orbital

# Verify the connection
xi orbital status
```

Configuration is stored at `~/.xio/config.json`.

### Interactive Mode

Launch `xi` with no arguments to enter the interactive TUI, a dashboard with Orbital status, peer network visualization, query interface, and key management.

```bash
xi
```

### CLI Commands

| Command | Description |
|---------|-------------|
| `xi config add <name> -e <url>` | Add a connection profile |
| `xi config list` | List all profiles |
| `xi config use <name>` | Switch active profile |
| `xi config show` | Show current configuration |
| `xi config rm <name>` | Remove a profile |
| `xi orbital status` | Orbital sync, hydration, and peer status |
| `xi orbital diag` | Full diagnostics |
| `xi orbital peers` | List peer Orbitals |
| `xi cluster instances` | List active cluster instances |
| `xi cluster status` | Cluster health summary |

Output formats: `table` (default), `json`, `yaml`.

## Using the Client Library

For programmatic integration, reference the **Xio.Client** library in your .NET project:

```csharp
using Xio.Client;

// Register via dependency injection
services.AddXioClient(options =>
{
    options.OrbitalEndpoints = new[] { "https://orbital.example.com" };
    options.EnableCaching = true;
    options.EnableProofVerification = true;
});
```

### Resolve a `.xio` Domain

```csharp
// Inject IXioResolverService
var request = new XioResolveRequest("example.xio", XioRecordType.XSIGN);
var response = await resolver.ResolveAsync(request);

// Response includes records and Sparse Merkle proofs
foreach (var record in response.Records)
{
    // Process signing metadata, fingerprints, etc.
}
```

The client handles protocol encoding, caching, and automatic Sparse Merkle proof verification.

## Core Libraries

XI Objects is composed of several .NET libraries, each with a focused responsibility:

| Library | Purpose |
|---------|---------|
| **Xio.Client** | SDK for resolving `.xio` domains: wire protocol, caching, proof verification |
| **Xio.Crypto** | Cryptographic primitives: Ed25519 signatures, BLAKE3 hashing, SMT proofs |
| **Xio.Protocol** | Wire protocol definitions: message format, record types, serialization |
| **Xio.Trust** | Trust block signing and verification: canonicalization, Ed25519 + BLAKE3 |
| **Xio.Verification** | Unified verification: document trust block verification, PKI chain validation, media fingerprint verification, and Orbital search matching |
| **Xio.ImageFingerprint.LWA** | Luminance Waveform Analysis: forensic image fingerprinting (waveform coherence, manipulation detection) and discriminative identity fingerprinting (pHash, color, spatial, block-level analysis) |
| **Xio.VideoFingerprint** | Dual-track video fingerprinting: visual (2D FFT) and audio (STFT/MFCC) waveforms with hierarchical aggregation, discriminative identity matching, forensic analysis, and manipulation detection |
| **Xio.Serialization** | XION document parsing and serialization: Markdown, JSON, Flat formats |
| **Xio.Distillation** | Schema-driven fact extraction with provenance from signed content |
| **Xio.Storage** | Sparse Merkle Tree storage |

## Services

| Service | Purpose |
|---------|--------|
| **Xio.Orbital** | The distributed verification network: wire protocol queries, record storage, peer sync, fingerprint search |
| **Xio.Control** | Certificate authority module: leaf certificate issuance and revocation (runs within Orbital) |
| **Xio.Forensics.Lab** | Media forensics laboratory: upload, fingerprint, register, compare, verify, and manipulation-test images and videos with full attribution resolution |

## Next Steps

- [Core Concepts](/docs/xio/concepts): Understand trust chains, the wire protocol, and fingerprinting
- [Certificates & Trust](/docs/xio/concepts/certificates): Learn about the certificate hierarchy
- [API Reference](/docs/xio/api): Full client library and protocol documentation
- [Guides](/docs/xio/guides): Step-by-step integration guides
<!-- xion:trust
{
  "v": 1,
  "canon_v": 1,
  "ctx": "xiobjects.com/content",
  "hash_blake3_hex": "ac0ba3313a5ff3972346a2e8f8e2e81b2b5834732e60e1778681d57e51cfd2b2",
  "hash_sha256_hex": null,
  "sig_alg": "ed25519",
  "sig_b64": "mYkAepFA6UOBU8C6v_ISh47nWu_MnVo6WNhWCpQ25CgBU1iACSrVUTjlO6tJES6ME7V7EjavsUZs9Hf6Z1ZmDQ",
  "pubkey_b64": "h-awvV8Rn-juph_c2Y7UH5A6e7NaFia3zBiMrJUOMOo",
  "x509_chain_pem": [
    "-----BEGIN CERTIFICATE-----\nMIIB9DCCAaagAwIBAgIQBrrNsmRlBvKQdA4idEliJjAFBgMrZXAwLjEsMCoGA1UE\nAwwjWEkgT2JqZWN0cyBJbmMgQ29udHJvbCBJbnRlcm1lZGlhdGUwHhcNMjYwNTEz\nMjI0NjA1WhcNMjYwNjEyMjI0NjA1WjBLMR4wHAYDVQQDDBV4aW8tY29udGVudC1w\ndWJsaXNoZXIxFzAVBgNVBAoMDlhJIE9iamVjdHMgSW5jMRAwDgYDVQQLDAdDb250\nZW50MCowBQYDK2VwAyEAh\u002BawvV8Rn\u002Bjuph/c2Y7UH5A6e7NaFia3zBiMrJUOMOqj\ngbwwgbkwDAYDVR0TAQH/BAIwADAOBgNVHQ8BAf8EBAMCB4AwEwYDVR0lBAwwCgYI\nKwYBBQUHAyQwZQYDVR0jBF4wXIAUOym3mFmw/qs1fgKrujCkxhrTk7KhLqQsMCox\nKDAmBgNVBAMMH0luc3RpdHV0ZSBvZiBQcm92ZW5hbmNlIFJvb3QgQ0GCFFJgN/ix\nQn72H6h3T5lEr9f8lJQFMB0GA1UdDgQWBBS1LSJi5\u002BeqBq8h974Ht9HTgIcdgTAF\nBgMrZXADQQCKjXbPwnk/DZHmLQstUWRzU6GSf\u002BSHTXTTZCtRLbmJKxT17Qlbpexc\nsRgdSpxNWpJPe9Fr4vwhRkESMqMIpgQO\n-----END CERTIFICATE-----\n",
    "-----BEGIN CERTIFICATE-----\nMIIByDCCAXqgAwIBAgIUUmA3\u002BLFCfvYfqHdPmUSv1/yUlAUwBQYDK2VwMCoxKDAm\nBgNVBAMMH0luc3RpdHV0ZSBvZiBQcm92ZW5hbmNlIFJvb3QgQ0EwHhcNMjUxMTAy\nMDMxNzEyWhcNMzAxMTAxMDMxNzEyWjAuMSwwKgYDVQQDDCNYSSBPYmplY3RzIElu\nYyBDb250cm9sIEludGVybWVkaWF0ZTAqMAUGAytlcAMhAFSS/pggSRmTcAMko7uc\nATH8OHgxVymd5mBFlPXbJkgio4GtMIGqMBIGA1UdEwEB/wQIMAYBAf8CAQAwDgYD\nVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBQ7KbeYWbD\u002BqzV\u002BAqu6MKTGGtOTsjBlBgNV\nHSMEXjBcgBQAZRTDswSVORu\u002BkUOKX6WvrOvmQKEupCwwKjEoMCYGA1UEAwwfSW5z\ndGl0dXRlIG9mIFByb3ZlbmFuY2UgUm9vdCBDQYIUJqoJlpiSFg\u002B7W5IJLMrLttgR\nQp4wBQYDK2VwA0EA5FOht7YOsVRPp/FOKMQ\u002B3Mo9JxrvGR3ylKWAWNm6OUV7N3DB\nI9cD62wU5I0d0EKDBy0CX9DnoqUyxv5yguraAA==\n-----END CERTIFICATE-----\n",
    "-----BEGIN CERTIFICATE-----\nMIIBaTCCARugAwIBAgIUJqoJlpiSFg\u002B7W5IJLMrLttgRQp4wBQYDK2VwMCoxKDAm\nBgNVBAMMH0luc3RpdHV0ZSBvZiBQcm92ZW5hbmNlIFJvb3QgQ0EwHhcNMjUxMTAy\nMDMwNTEyWhcNMzUxMDMxMDMwNTEyWjAqMSgwJgYDVQQDDB9JbnN0aXR1dGUgb2Yg\nUHJvdmVuYW5jZSBSb290IENBMCowBQYDK2VwAyEAEWNZl\u002Br3IC7\u002BgBh90Yo1kWk1\npZCVzVuFdFT7qBBU8W2jUzBRMB0GA1UdDgQWBBQAZRTDswSVORu\u002BkUOKX6WvrOvm\nQDAfBgNVHSMEGDAWgBQAZRTDswSVORu\u002BkUOKX6WvrOvmQDAPBgNVHRMBAf8EBTAD\nAQH/MAUGAytlcANBAO6QeydOFNrN75qNyftggYudsxMyl4w9qWkSdZ6hlhrRcbSr\niG9Si0kbrIJOwYB/LTBU0RM4Rl\u002Bo9PM3Qp0mPwo=\n-----END CERTIFICATE-----\n"
  ],
  "key_id": "SDyVO7FvlAM-6CvQ62VZYOBO7JADFqLquUunUABRgKg",
  "created_at": "2026-05-13T22:51:27Z"
}
-->