Xberg

https://github.com/xberg-io/xberg
Admin
Xberg is a document-intelligence framework with a Rust core and native bindings for 16 languages. It...
Tokens:3,930,970
Snippets:24,839
Trust Score:8
License:MIT
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Quick start with DocumentPipeline

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/integrations/surrealdb.md

Quick start example: creates a DocumentPipeline with embeddings enabled, sets up the schema, and ingests all PDFs in a directory.

```python
from surrealdb_xberg import DocumentPipeline

pipeline = DocumentPipeline(db=db, embed=True, embedding_model="balanced")
await pipeline.setup_schema()
await pipeline.ingest_directory("./papers", glob="**/*.pdf")
```

--------------------------------

### Install Go binding

Source: https://github.com/xberg-io/xberg/blob/main/plugin/skills/xberg/references/other-bindings.md

Install the Xberg Go package using go get.

```bash
go get github.com/xberg-io/xberg/packages/go
```

--------------------------------

### Registry#summaries example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-ruby.md

Example call to get the list of preset summaries. Returns an Array<PresetSummary>.

```ruby
result = instance.summaries()
```

--------------------------------

### serve_with_config() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of serve_with_config, loading configuration from a TOML file and starting the server on 127.0.0.1:8000.

```rust
use xberg::{ExtractionConfig, api::serve_with_config};

#[tokio::main]
async fn main() -> xberg::Result<()> {
    let config = ExtractionConfig::from_toml_file("config/xberg.toml")?;
    serve_with_config("127.0.0.1", 8000, config).await?;
    Ok(())
}
```

--------------------------------

### Quick start with DocumentPipeline

Source: https://github.com/xberg-io/xberg/blob/main/integrations/python/surrealdb/README.md

Quick start example: connects to SurrealDB, sets up the DocumentPipeline with embeddings, ingests a directory of PDFs, and performs a vector search over chunks. Demonstrates the full workflow.

```python
import asyncio

from surrealdb import AsyncSurreal
from surrealdb_xberg import DocumentPipeline


async def main() -> None:
    async with AsyncSurreal("ws://localhost:8000") as db:
        await db.signin({"username": "root", "password": "root"})
        await db.use("app", "docs")

        pipeline = DocumentPipeline(db=db, embed=True, embedding_model="balanced")
        await pipeline.setup_schema()  # probes the embedding dimension, then creates tables + indexes

        # One extract_batch call for the whole directory, then batched idempotent inserts.
        await pipeline.ingest_directory("./papers", glob="**/*.pdf")

        # Vector search over chunks.
        embedding = await pipeline.embed_query("retrieval augmented generation")
        hits = await pipeline.client.query(
            f"SELECT document.source AS source, content, vector::distance::knn() AS distance "
            f"FROM {pipeline.chunk_table} WHERE embedding <|5,COSINE|> $embedding ORDER BY distance",
            {"embedding": embedding},
        )
        print(hits)


asyncio.run(main())
```

--------------------------------

### Start server examples

Source: https://github.com/xberg-io/xberg/blob/main/plugin/skills/xberg/references/cli-reference.md

Starts the server with defaults, custom host/port, config file, or environment variables. CLI args override config and env vars; env vars override config file.

```bash
xberg serve

```

```bash
xberg serve --host 0.0.0.0 --port 3000

```

```bash
xberg serve --config xberg.toml

```

```bash
XBERG_HOST=192.168.1.100 XBERG_PORT=8080 xberg serve

```

--------------------------------

### Run task setup

Source: https://github.com/xberg-io/xberg/blob/main/CONTRIBUTING.md

Installs all dependencies and sets up pre-commit hooks via poly. This command is idempotent.

```bash
task setup
```

--------------------------------

### Registry#get example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-ruby.md

Example call to retrieve a preset by id. The id parameter is a required String.

```ruby
result = instance.get("value")
```

--------------------------------

### Install toolchains, lint, and test with Task

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/getting-started/installation.mdx

Run these commands in the repository root to set up the development environment. `task setup` installs all language toolchains, `task lint` runs linters across all languages, and `task dev:test` runs the full test suite.

```bash
task setup      # installs all language toolchains
task lint        # linters across all languages
task dev:test    # full test suite
```

--------------------------------

### Registry.len/1 signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-elixir.md

Signature and example for getting the number of presets currently loaded. Returns integer().

```elixir
def len(obj)
```

```elixir
{:ok, result} = instance.len()
```

--------------------------------

### serve_with_config_and_limits() - Start API server with config and limits

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Starts the API server with explicit configuration and size limits. The example loads an ExtractionConfig from a TOML file and sets ApiSizeLimits to 200 MB for both request bodies and multipart uploads. Returns Err(XbergError) on failure.

```rust
pub async fn serve_with_config_and_limits(host: String, port: u16, config: ExtractionConfig, limits: ApiSizeLimits) -> Result<(), XbergError>
```

```rust
use xberg::{ExtractionConfig, api::{serve_with_config_and_limits, ApiSizeLimits}};

#[tokio::main]
async fn main() -> xberg::Result<()> {
    let config = ExtractionConfig::from_toml_file("config/xberg.toml")?;
    let limits = ApiSizeLimits::from_mb(200, 200);
    serve_with_config_and_limits("127.0.0.1", 8000, config, limits).await?;
    Ok(())
}
```

--------------------------------

### Install and run the CLI

Source: https://github.com/xberg-io/xberg/blob/main/plugin/skills/xberg/SKILL.md

Install the CLI via Homebrew, run it without a persistent install using npx or uvx, download a prebuilt binary from the latest GitHub release, or build from source with cargo install.

```bash
brew install xberg-io/tap/xberg
# or run without a persistent install (the CLI proxy package self-installs the binary):
npx @xberg-io/xberg-cli --help
uvx --from xberg-cli xberg --help
# or download a prebuilt binary from the latest GitHub release:
#   https://github.com/xberg-io/xberg/releases/latest
# or build from source:
cargo install xberg-cli
```

--------------------------------

### Registry.get() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-wasm.md

Signature and example for the get() method. Looks up a preset by its identifier. Returns Preset | null.

```typescript
get(id: string): Preset | null
```

```typescript
const result = instance.get("value");
```

--------------------------------

### start_mcp_server_with_config() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of start_mcp_server_with_config. It starts the MCP server with a default ExtractionConfig. The function returns no value and errors with Err(ErrorSendSync) on failure.

```rust
start_mcp_server_with_config(ExtractionConfig::default()).await?;
```

--------------------------------

### Get() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-csharp.md

Looks up a preset by its identifier. Returns null if not found.

```csharp
public Preset? Get(string id)
```

```csharp
var result = instance.Get("value");
```

--------------------------------

### Basic usage of tesseract-rs in Rust

Source: https://github.com/xberg-io/xberg/blob/main/crates/xberg-tesseract/README.md

Complete example showing how to initialize TesseractAPI, set an image, configure whitelist and PSM mode, and get recognized text. Handles tessdata directory selection via TESSDATA_PREFIX or default locations.

```rust
use std::path::PathBuf;
use std::error::Error;
use xberg_tesseract::TesseractAPI;

fn get_default_tessdata_dir() -> PathBuf {
    if cfg!(target_os = "macos") {
        let home_dir = std::env::var("HOME").expect("HOME environment variable not set");
        PathBuf::from(home_dir)
            .join("Library")
            .join("Application Support")
            .join("tesseract-rs")
            .join("tessdata")
    } else if cfg!(target_os = "linux") {
        let home_dir = std::env::var("HOME").expect("HOME environment variable not set");
        PathBuf::from(home_dir)
            .join(".tesseract-rs")
            .join("tessdata")
    } else if cfg!(target_os = "windows") {
        PathBuf::from(std::env::var("APPDATA").expect("APPDATA environment variable not set"))
            .join("tesseract-rs")
            .join("tessdata")
    } else {
        panic!("Unsupported operating system");
    }
}

fn get_tessdata_dir() -> PathBuf {
    match std::env::var("TESSDATA_PREFIX") {
        Ok(dir) => {
            let path = PathBuf::from(dir);
            println!("Using TESSDATA_PREFIX directory: {:?}", path);
            path
        }
        Err(_) => {
            let default_dir = get_default_tessdata_dir();
            println!(
                "TESSDATA_PREFIX not set, using default directory: {:?}",
                default_dir
            );
            default_dir
        }
    }
}

fn main() -> Result<(), Box<dyn Error>> {
    let api = TesseractAPI::new()?;

    // Get tessdata directory (uses default location or TESSDATA_PREFIX if set)
    let tessdata_dir = get_tessdata_dir();
    api.init(tessdata_dir.to_str().unwrap(), "eng")?;

    let width = 24;
    let height = 24;
    let bytes_per_pixel = 1;
    let bytes_per_line = width * bytes_per_pixel;

    // Initialize image data with all white pixels
    let mut image_data = vec![255u8; width * height];

    // Draw number 9 with clearer distinction
    for y in 4..19 {
        for x in 7..17 {
            // Top bar
            if y == 4 && x >= 8 && x <= 15 {
                image_data[y * width + x] = 0;
            }
            // Top curve left side
            if y >= 4 && y <= 10 && x == 7 {
                image_data[y * width + x] = 0;
            }
            // Top curve right side
            if y >= 4 && y <= 11 && x == 16 {
                image_data[y * width + x] = 0;
            }
            // Middle bar
            if y == 11 && x >= 8 && x <= 15 {
                image_data[y * width + x] = 0;
            }
            // Bottom right vertical line
            if y >= 11 && y <= 18 && x == 16 {
                image_data[y * width + x] = 0;
            }
            // Bottom bar
            if y == 18 && x >= 8 && x <= 15 {
                image_data[y * width + x] = 0;
            }
        }
    }

    // Set the image data
    api.set_image(
        &image_data,
        width.try_into().unwrap(),
        height.try_into().unwrap(),
        bytes_per_pixel.try_into().unwrap(),
        bytes_per_line.try_into().unwrap(),
    )?;

    // Set whitelist for digits only
    api.set_variable("tessedit_char_whitelist", "0123456789")?;

    // Set PSM mode to single character
    api.set_variable("tessedit_pageseg_mode", "10")?;

    // Get the recognized text
    let text = api.get_utf8_text()?;
    println!("Recognized text: {}", text.trim());

    Ok(())
}
```

--------------------------------

### Convert a single PDF with DocumentConverter and render as Markdown

Source: https://github.com/xberg-io/xberg/blob/main/tools/benchmark-harness/vendored/docling/md/docling.md

Shown as a basic usage example in the Getting Started section. It converts a PDF from a URL (or file path) and prints the rendered Markdown. The example imports DocumentConverter from docling.document_converter and demonstrates the convert_single method.

```text
source = "https://arxiv.org/pdf/2206.01062" # PDF path or URL converter = DocumentConverter() result = converter.convert_single(source) print(result.render_as_markdown()) # output: "## DocLayNet: A Large Human -Annotated Dataset for Document -Layout Analysis [...]"
```

--------------------------------

### Run MCP server with prebuilt binary

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/mcp-integration.mdx

Starts the Xberg MCP server over stdio using a prebuilt binary. Requires the binary to be installed via Homebrew, install.sh, or Docker.

```bash
xberg mcp
```

--------------------------------

### confidenceSemantics() usage example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-wasm.md

Example usage of confidenceSemantics() to get the confidence semantics for the backend.

```typescript
const result = instance.confidenceSemantics();
```

--------------------------------

### Example Configuration File (TOML)

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/environment-variables.md

Shows a TOML configuration file for complex settings, recommended over environment variables for many settings.

```toml
# xberg.toml is cleaner for multiple settings
[ocr]
language = "eng"
backend = "tesseract"

[chunking]
max_chars = 2000
max_overlap = 300
```

--------------------------------

### GET /jobs/{job_id}: completed response example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/api-server.mdx

Example response from GET /jobs/{job_id} when the job is completed. The result field is present only when state is completed; the error field only when state is failed.

```json
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "state": "completed",
  "created_at": "2026-07-07T12:00:00Z",
  "updated_at": "2026-07-07T12:00:03Z",
  "result": { "results": [], "errors": [], "summary": {} }
}
```

--------------------------------

### Registry#len example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-ruby.md

Example call to get the count of loaded presets. Returns an Integer.

```ruby
result = instance.len()
```

--------------------------------

### pageOrientationHandling() usage example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-wasm.md

Example usage of pageOrientationHandling() to get the page orientation handling for the backend.

```typescript
const result = instance.pageOrientationHandling();
```

--------------------------------

### Install uv and set up git hooks

Source: https://github.com/xberg-io/xberg/blob/main/crates/xberg-tesseract/README.md

Installs uv and sets up git hooks for contributors. Run these commands after forking and cloning the repository.

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
uvx prek install
```

--------------------------------

### Install via install script (Linux/macOS)

Source: https://github.com/xberg-io/xberg/blob/main/crates/xberg-cli/README.md

One-line installer for Linux and macOS. Downloads and runs the official install script from the xberg repository.

```bash
curl -fsSL https://raw.githubusercontent.com/xberg-io/xberg/main/scripts/install.sh | bash
```

--------------------------------

### Run chunk_explorer.py example

Source: https://github.com/xberg-io/xberg/blob/main/integrations/python/surrealdb/examples/README.md

Runs the chunk explorer example, which demonstrates record link traversal and chunk navigation.

```bash
uv run python examples/chunk_explorer.py <path-to-directory>
```

--------------------------------

### Install Go package via go get

Source: https://github.com/xberg-io/xberg/blob/main/packages/go/README.md

Installs the Xberg Go package using go get. Use the /packages/go subdirectory; the bare-root path fails due to a stale module-proxy cache entry.

```bash
# Get the latest release
go get github.com/xberg-io/xberg/packages/go@latest

# Or a specific version
go get github.com/xberg-io/xberg/packages/go@v1.3.3
```

--------------------------------

### supported_languages/1 signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-elixir.md

Signature and example for the supported_languages/1 callback. The example calls instance.supported_languages/0 with no arguments, returning {:ok, result}.

```elixir
def supported_languages(obj)
```

```elixir
{:ok, result} = instance.supported_languages()
```

--------------------------------

### xberg serve examples

Source: https://github.com/xberg-io/xberg/blob/main/crates/xberg-cli/README.md

Examples of serve command: default, public access, custom config.

```bash
# Default: localhost:8000
xberg serve

# Public access on port 3000
xberg serve --host 0.0.0.0 --port 3000

# With custom configuration
xberg serve --config server-config.toml --port 8080
```

--------------------------------

### serve() example for Docker/production

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of serve for Docker/production, listening on all interfaces (0.0.0.0) on port 8000.

```rust
use xberg::api::serve;

#[tokio::main]
async fn main() -> xberg::Result<()> {
    // Docker/production (listen on all interfaces)
    serve("0.0.0.0", 8000).await?;
    Ok(())
}
```

--------------------------------

### DocumentExtractor.priority signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-elixir.md

Signature and example for getting the extractor priority. The example returns {:ok, result} where result is an integer priority value (default 50).

```elixir
def priority(obj)
```

```elixir
{:ok, result} = instance.priority()
```

--------------------------------

### serve() example for local development

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of serve for local development, binding to 127.0.0.1 on port 8000.

```rust
use xberg::api::serve;

#[tokio::main]
async fn main() -> xberg::Result<()> {
    // Local development
    serve("127.0.0.1", 8000).await?;
    Ok(())
}
```

--------------------------------

### Start xberg server with exec.Command

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/snippets/api_server/go.md

Starts the xberg server programmatically from Go, binding to 0.0.0.0 on port 8000. Logs output and errors via the standard log package, and exits with a fatal error if the server fails to start.

```go
package main

import (
    "log"
    "os/exec"
)

func main() {
    cmd := exec.Command("xberg", "serve", "-H", "0.0.0.0", "-p", "8000")
    cmd.Stdout = log.Writer()
    cmd.Stderr = log.Writer()
    if err := cmd.Run(); err != nil {
        log.Fatalf("failed to start server: %v", err)
    }
}

```

--------------------------------

### xberg_post_processor_processing_stage() - Get processing stage

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-c.md

Get the processing stage (Early, Middle, or Late) for this post-processor. The example assigns the returned handle to a variable.

```c
XBERGAlefHandle xberg_post_processor_processing_stage(XBERGAlefHandle this);
```

```c
XBERGAlefHandle result = xberg_post_processor_processing_stage(instance);
```

--------------------------------

### supports_table_detection/1 signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-elixir.md

Signature and example for the supports_table_detection/1 callback. The example calls instance.supports_table_detection/0 with no arguments, returning {:ok, result}.

```elixir
def supports_table_detection(obj)
```

```elixir
{:ok, result} = instance.supports_table_detection()
```

--------------------------------

### ServerConfig::max_multipart_field_mb() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example of using max_multipart_field_mb() to get the maximum multipart field size in megabytes. Asserts that the default config returns 100.

```rust
use xberg::core::ServerConfig;

let mut config = ServerConfig::default();
assert_eq!(config.max_multipart_field_mb(), 100);
```

--------------------------------

### Build and serve docs with task commands

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/development.md

Commands to build and serve the documentation site locally. `docs:build` runs pnpm install and astro build; `docs:serve` runs pnpm install and astro dev with live reload.

```bash
task docs:build         # pnpm install + astro build
task docs:serve         # pnpm install + astro dev (live reload)
```

--------------------------------

### Install Tesseract and verify

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/ocr.mdx

Install Tesseract on macOS or Ubuntu/Debian and verify the installation with tesseract --version. Required when the Tesseract backend is not found.

```bash
# macOS
brew install tesseract

# Ubuntu/Debian
sudo apt-get install tesseract-ocr

# Verify
tesseract --version
```

--------------------------------

### ServerConfig::max_request_body_mb() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example of using max_request_body_mb() to get the maximum request body size in megabytes. Asserts that the default config returns 100.

```rust
use xberg::core::ServerConfig;

let mut config = ServerConfig::default();
assert_eq!(config.max_request_body_mb(), 100);
```

--------------------------------

### QrCodeProcessor::process() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example call to the process() method.

```rust
instance.process(&mut todo!(), &todo!()).await?;
```

--------------------------------

### ServerConfig::listen_addr() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example of using listen_addr() to get the server listen address. Asserts that the default config returns "127.0.0.1:8000".

```rust
use xberg::core::ServerConfig;

let config = ServerConfig::default();
assert_eq!(config.listen_addr(), "127.0.0.1:8000");
```

--------------------------------

### POST /extract-async: 202 response example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/api-server.mdx

Example 202 Accepted response from POST /extract-async, containing the job_id to poll with GET /jobs/{job_id}.

```json
{ "job_id": "550e8400-e29b-41d4-a716-446655440000" }
```

--------------------------------

### Plugin initialize() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example implementation of the initialize() method. Uses interior mutability (Mutex) to load configuration. Returns an error if initialization fails; defaults to a no-op for stateless plugins.

```rust
fn initialize(&self) -> Result<()> {
    // Load configuration using interior mutability
    let mut config = self.config.lock().unwrap();
    *config = Some("loaded".to_string());

    // Perform any initialization work
    println!("Plugin initialized successfully");

    Ok(())
}
```

--------------------------------

### Calling Plugin Description()

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

Example call to the Description method, returning the plugin's description as a string.

```go
result := instance.Description()
```

--------------------------------

### Run search_patterns.py example

Source: https://github.com/xberg-io/xberg/blob/main/integrations/python/surrealdb/examples/README.md

Runs the search patterns example, which demonstrates BM25, vector, and hybrid search in an interactive loop.

```bash
uv run python examples/search_patterns.py <path-to-directory>
```

--------------------------------

### start_mcp_server() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of start_mcp_server. It starts the MCP server with stdio transport and blocks until shutdown. The function returns no value and errors with Err(ErrorSendSync) on failure.

```rust
use xberg::mcp::start_mcp_server;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    start_mcp_server().await?;
    Ok(())
}
```

--------------------------------

### PageRange.PageCount() usage example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

Calls PageCount() on an instance of PageRange to get the page count.

```go
result := instance.PageCount()
```

--------------------------------

### Run live browser demo locally

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/development.md

Build the Wasm binary and TypeScript dist, patch the demo with local URLs, and start two servers (Docs on port 8001, Assets on port 9000). Open `http://localhost:8001/demo-dev.html` to test local changes against the live browser demo.

```bash
task demo:dev
```

--------------------------------

### Clone and Setup Xberg

Source: https://github.com/xberg-io/xberg/blob/main/packages/ruby/README.md

Clone the Xberg repository and install Ruby dependencies with Bundler.

```bash
git clone https://github.com/xberg-io/xberg.git
cd xberg
bundle install
```

--------------------------------

### serve()

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Starts the API server with config file discovery. Searches for xberg.toml/yaml/yml/json in current and parent directories. If no config file is found, uses default configuration.

```APIDOC
## serve()

### Description
Starts the API server with config file discovery. Searches for xberg.toml/yaml/yml/json in current and parent directories. If no config file is found, uses default configuration.

### Signature
```rust
pub async fn serve(host: String, port: u16) -> Result<(), XbergError>
```

### Parameters
- **host** (String) - Required - IP address to bind to (e.g., "127.0.0.1" or "0.0.0.0")
- **port** (u16) - Required - Port number to bind to (e.g., 8000)

### Returns
No return value.

### Errors
Returns `Err(XbergError)`.

### Example
```rust
use xberg::api::serve;

#[tokio::main]
async fn main() -> xberg::Result<()> {
    // Local development
    serve("127.0.0.1", 8000).await?;
    Ok(())
}
```

```rust
use xberg::api::serve;

#[tokio::main]
async fn main() -> xberg::Result<()> {
    // Docker/production (listen on all interfaces)
    serve("0.0.0.0", 8000).await?;
    Ok(())
}
```

```bash
# Python/Docker usage
export XBERG_HOST=0.0.0.0
export XBERG_PORT=8000

# CORS configuration (IMPORTANT for production security)
# Default: allows all origins (permits CSRF attacks)
# Production: set to comma-separated list of allowed origins
export XBERG_CORS_ORIGINS="https://app.example.com,https://api.example.com"

# Upload size limits (default: 100 MB)
# Modern approach (in bytes):
export XBERG_MAX_REQUEST_BODY_BYTES=104857600       # 100 MB
export XBERG_MAX_MULTIPART_FIELD_BYTES=104857600    # 100 MB per file

python -m xberg.api
```
```

--------------------------------

### listRerankerBackends() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-java.md

Example call to listRerankerBackends(), returning a List<String> of backend names.

```java
var result = listRerankerBackends();
```

--------------------------------

### Text annotation JSON example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/output-formats.mdx

Example of an annotation object marking a character span in a paragraph. The start and end fields define the span, and the kind field contains the annotation type.

```json
{ "start": 0, "end": 16, "kind": { "annotation_type": "bold" } }
```

--------------------------------

### create_client_with_credential_provider usage example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of create_client_with_credential_provider. It passes a default LlmConfig and a placeholder provider (todo!()) and uses the ? operator to propagate errors.

```rust
let result = create_client_with_credential_provider(&LlmConfig::default(), todo!())?;
```

--------------------------------

### DoctorCheck::fail() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Creates a DoctorCheck with a Fail verdict, indicating the configured setup will not work or will silently degrade on this host. The example shows constructing a check with placeholder values.

```rust
pub fn fail(name: String, message: String) -> DoctorCheck
```

```rust
let result = DoctorCheck::fail("value", "value");
```

--------------------------------

### Registry.sampleBytes() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-kotlin-android.md

Calls sampleBytes() with a preset id and sample name.

```kotlin
val result = instance.sampleBytes("value", "value")
```

--------------------------------

### CaptioningConfigDefaultMinImageArea() usage example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

Calls the function to get the default minimum image area value.

```go
result := CaptioningConfigDefaultMinImageArea()
```

--------------------------------

### xberg_ocr_backend_supported_languages_for() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-c.md

Declares the optional function that returns the list of languages supported by the OCR backend under a given configuration. The example calls it with a null config handle (0) to get the result.

```c
const char* xberg_ocr_backend_supported_languages_for(XBERGAlefHandle this, XBERGAlefHandle config);
```

```c
const char* result = xberg_ocr_backend_supported_languages_for(instance, 0);
```

--------------------------------

### initialize() method signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-java.md

Signature and example for the initialize() method. Called once when the plugin is registered; defaults to a no-op for stateless plugins. Throws XbergRsException on failure.

```java
public void initialize() throws XbergRsException
```

```java
instance.initialize();
```

--------------------------------

### VERIFY_GROUP_FOR_USER function

Source: https://github.com/xberg-io/xberg/blob/main/tools/benchmark-harness/vendored/docling/md/redp5110_sampled.md

Documentation for the VERIFY_GROUP_FOR_USER SQL function, including syntax, parameters, return value, and usage examples.

```APIDOC
## VERIFY_GROUP_FOR_USER function

### Description
Verifies whether the current user is in a list of user or group profiles. Returns 1 if the special register value is in the list or is a member of a group profile in the list; otherwise returns 0. Never returns null.

### Syntax
VERIFY_GROUP_FOR_USER ( special_register, profile1 [, profile2, ...] )

### Parameters
- **special_register** (special register) - Required - Must be one of SESSION_USER, USER, or CURRENT_USER.
- **profile1, profile2, ...** (character) - Required - List of user or group profiles. Each value must be 1-10 characters in length. Values are not validated for existence.

### Return Value
- **long integer** - Returns 1 if the special register value is in the list or is a member of a group profile in the list; otherwise returns 0. Never returns null.

### Example
```sql
VERIFY_GROUP_FOR_USER (CURRENT_USER, 'MGR')
VERIFY_GROUP_FOR_USER (CURRENT_USER, 'JANE', 'MGR')
VERIFY_GROUP_FOR_USER (CURRENT_USER, 'JANE', 'MGR', 'STEVE')
```

### Usage in Column Mask
```sql
RETURN CASE WHEN VERIFY_GROUP_FOR_USER ( SESSION_USER , 'HR', 'EMP' ) = 1 THEN EMPLOYEES . DATE_OF_BIRTH WHEN VERIFY_GROUP_FOR_USER ( SESSION_USER , 'MGR' ) = 1 AND SESSION_USER = EMPLOYEES . USER_ID THEN EMPLOYEES . DATE_OF_BIRTH WHEN VERIFY_GROUP_FOR_USER ( SESSION_USER , 'MGR' ) = 1 AND SESSION_USER <> EMPLOYEES . USER_ID THEN ( 9999 || '-' ||  MONTH ( EMPLOYEES . DATE_OF_BIRTH ) || '-'     || DAY (EMPLOYEES.DATE_OF_BIRTH )) ELSE NULL END ENABLE  ;
```
```

--------------------------------

### CREATE MASK statement

Source: https://github.com/xberg-io/xberg/blob/main/tools/benchmark-harness/vendored/docling/md/redp5110_sampled.md

Documentation for the CREATE MASK SQL statement used to create column masks, including syntax and an example.

```APIDOC
## CREATE MASK statement

### Description
Creates a column mask on a table column. The mask uses a CASE expression to determine the value returned based on the current user and group memberships.

### Syntax
CREATE MASK schema.mask_name ON schema.table AS alias FOR COLUMN column_name RETURN CASE ... END ENABLE ;

### Parameters
- **schema.mask_name** (identifier) - Required - Name of the mask to create.
- **schema.table** (identifier) - Required - Table on which the mask is created.
- **alias** (identifier) - Required - Alias for the table used in the mask expression.
- **column_name** (identifier) - Required - Column to be masked.
- **CASE expression** - Required - Defines the masking logic.

### Example
```sql
CREATE MASK   HR_SCHEMA.MASK_TAX_ID_ON_EMPLOYEES ON            HR_SCHEMA.EMPLOYEES AS EMPLOYEES FOR COLUMN    TAX_ID RETURN CASE WHEN VERIFY_GROUP_FOR_USER ( SESSION_USER , 'HR' ) = 1 THEN EMPLOYEES . TAX_ID WHEN VERIFY_GROUP_FOR_USER ( SESSION_USER , 'MGR' ) = 1 AND SESSION_USER = EMPLOYEES . USER_ID THEN EMPLOYEES . TAX_ID WHEN VERIFY_GROUP_FOR_USER ( SESSION_USER , 'MGR' ) = 1 AND SESSION_USER <> EMPLOYEES . USER_ID THEN ( 'XXX-XX-' CONCAT QSYS2 . SUBSTR ( EMPLOYEES . TAX_ID , 8 , 4 ) ) WHEN VERIFY_GROUP_FOR_USER ( SESSION_USER , 'EMP' ) = 1 THEN EMPLOYEES . TAX_ID ELSE 'XXX-XX-XXXX' END ENABLE  ;
```
```

--------------------------------

### Plugin initialize() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-elixir.md

Signature and example for the initialize/1 callback, called once when the plugin is registered. Returns {:error, reason} on failure; defaults to a no-op for stateless plugins.

```elixir
def initialize(obj)
```

```elixir
:ok = instance.initialize()
```

--------------------------------

### start_mcp_server_http() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of start_mcp_server_http. It starts the MCP server on host 127.0.0.1 and port 8001 with no extra allowed hosts. The function returns no value and errors with Err(ErrorSendSync) on failure.

```rust
use xberg::mcp::start_mcp_server_http;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    start_mcp_server_http("127.0.0.1", 8001, &[]).await?;
    Ok(())
}
```

--------------------------------

### Ground-truth sidecar JSON schema

Source: https://github.com/xberg-io/xberg/blob/main/tools/generate_test_fixtures/README.md

Example JSON object shape for a ground-truth sidecar file, showing required fields and structure.

```json
{
  "fixture_path": "test_documents/generated/docx/docx_track_changes_basic.docx",
  "format": "docx",
  "feature": "revisions",
  "expectations": { ... feature-specific shape ... },
  "generated_by": "generate-test-fixtures 0.1.0"
}
```

--------------------------------

### listTokenizerBackends() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-java.md

Example call to listTokenizerBackends(), returning a List<String> of backend names.

```java
var result = listTokenizerBackends();
```

--------------------------------

### CHGFCNUSG command to grant RCAC administration

Source: https://github.com/xberg-io/xberg/blob/main/tools/benchmark-harness/vendored/docling/md/redp5110_sampled.md

Example of the Change Function Usage (CHGFCNUSG) CL command that grants user HBEDOYA authorization to administer and manage RCAC rules. The command uses FCNID(QIBM_DB_SECADM) and USAGE(*ALLOWED).

```cl
CHGFCNUSG FCNID(QIBM_DB_SECADM) USER(HBEDOYA) USAGE(*ALLOWED)
```

--------------------------------

### Install ONNX Runtime (Windows)

Source: https://github.com/xberg-io/xberg/blob/main/packages/python/README.md

Provides installation guidance for ONNX Runtime on Windows, directing to download from GitHub releases.

```bash
# Windows
# Download from https://github.com/microsoft/onnxruntime/releases
```

--------------------------------

### Start MCP Server with HTTP Transport

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/mcp-integration.mdx

Starts the MCP server with HTTP transport, requiring the mcp-http feature flag at build time. Exposes the same tool interface over the network for remote or multi-client setups.

```bash
xberg mcp --transport http --host 127.0.0.1 --port 8001
```

--------------------------------

### Calling Plugin Initialize()

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

Example call to the Initialize method, returning an error if initialization fails. The plugin will not be registered if this method returns an error.

```go
if err := instance.Initialize(); err != nil {
    return err
}
```

--------------------------------

### RunsOcrOnEmbeddedImages() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

Signature and example for the RunsOcrOnEmbeddedImages method on ExtractionConfig. Returns whether embedded images get OCR'd, based on the ocr_embedded_images setting or presence of an ocr block, unless disable_ocr is set.

```go
func (o *ExtractionConfig) RunsOcrOnEmbeddedImages() bool
```

```go
result := instance.RunsOcrOnEmbeddedImages()
```

--------------------------------

### ServerConfig::default() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example of calling ServerConfig::default() to create a new ServerConfig instance with default settings.

```rust
let result = ServerConfig::default();
```

--------------------------------

### start_mcp_server_http_with_config() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of start_mcp_server_http_with_config. It starts the MCP HTTP server on host 127.0.0.1 and port 8001 with a default ExtractionConfig and no extra allowed hosts. The function returns no value and errors with Err(ErrorSendSync) on failure.

```rust
use xberg::mcp::start_mcp_server_http_with_config;
use xberg::ExtractionConfig;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    let config = ExtractionConfig::default();
    start_mcp_server_http_with_config("127.0.0.1", 8001, config, &[]).await?;
    Ok(())
}
```

--------------------------------

### create_router() example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Example usage of create_router with default configuration and size limits.

```rust
use xberg::{ExtractionConfig, api::create_router};

# #[tokio::main]
# async fn main() {
// Create router with default config and size limits
let config = ExtractionConfig::default();
let router = create_router(config);
# }
```

--------------------------------

### Clear all post-processors with Xberg.clearPostProcessors()

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/snippets-generated/java/plugin_api/post_processors_clear.md

Clears all registered post-processors by calling Xberg.clearPostProcessors(). The example is safe to run and requires no additional setup.

```java
import io.xberg.*;

public final class Example {
    public static void main(String[] args) throws Exception {
        Xberg.clearPostProcessors();
    }
}
```

--------------------------------

### Registry.extend_from_dir/2 signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-elixir.md

Signature and example for loading additional preset files from a runtime directory. Reads every *.json file directly under dir, validates against the meta-schema, and inserts them. Returns the number of presets successfully loaded, or {:error, reason} on failure.

```elixir
def extend_from_dir(obj, dir)
```

```elixir
{:ok, result} = instance.extend_from_dir("value")
```

--------------------------------

### GET /jobs/{job_id}: curl example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/api-server.mdx

Use GET /jobs/{job_id} to poll the status of an async job. The state field is one of pending, running, completed, or failed. Jobs expire after 5 minutes and return 404 once evicted.

```bash
curl http://localhost:8000/jobs/550e8400-e29b-41d4-a716-446655440000
```

--------------------------------

### PostProcessor.Process signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

The Process method signature and an example call. The example shows how to invoke Process with empty arguments and handle a returned error by propagating it.

```go
func (o *PostProcessor) Process(result ExtractedDocument, config ExtractionConfig) error
```

```go
if err := instance.Process(ExtractedDocument{}, ExtractionConfig{}); err != nil {
    return err
}
```

--------------------------------

### Install for Ruby, Go, and C#

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/features.mdx

Install the package for Ruby, Go, and C# using their respective package managers.

```bash
gem install xberg                  # Ruby
go get github.com/xberg-io/xberg/packages/go  # Go
dotnet add package XbergIo.Xberg   # C#
```

--------------------------------

### PageSignals::from_page_text - signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Signature and example for the PageSignals::from_page_text constructor. Use when you have only plain-text content of a page (e.g. from PageContent) and need to derive per-page signals. The heuristics are conservative starting points; tune thresholds via MultidocThresholds rather than changing these heuristics.

```rust
pub fn from_page_text(page_number: u32, text: &str, layout_text_density: f32) -> PageSignals
```

```rust
let result = PageSignals::from_page_text(42, "value", 0.5);
```

--------------------------------

### Source library paths and run Python tests

Source: https://github.com/xberg-io/xberg/blob/main/scripts/ci/README.md

Source the library paths setup script, call setup_all_library_paths to configure environment paths, then run the Python tests with coverage.

```bash
source ./scripts/lib/library-paths.sh
setup_all_library_paths
./scripts/ci/python/run-tests.sh true
```

--------------------------------

### Plugin.initialize() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-dart.md

Signature and example for the Plugin.initialize() method, called once when the plugin is registered. It should load configuration and initialize resources; errors prevent registration. Defaults to a no-op for stateless plugins.

```dart
Future<void> initialize()
```

```dart
instance.initialize();
```

--------------------------------

### Embed extracted document text

Source: https://github.com/xberg-io/xberg/blob/main/plugin/skills/extracting-keywords/SKILL.md

Pipe extracted content into embed to get document embeddings. This example uses the quality preset for the local provider.

```bash
# Embed extracted document text
xberg extract report.pdf | xberg embed --preset quality
```

--------------------------------

### Build and run MCP server from source

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/guides/mcp-integration.mdx

Installs the Xberg CLI with the MCP feature flag and starts the server. Requires Rust/Cargo and the 'mcp' feature.

```bash
cargo install xberg-cli --features mcp
xberg mcp
```

--------------------------------

### get_preset signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Signature and example for get_preset, which looks up a bundled SPLADE preset by exact name.

```rust
pub fn get_preset(name: &str) -> Option<SparseEmbeddingPreset>
```

```rust
let result = get_preset("value");
```

--------------------------------

### Build static library from source

Source: https://github.com/xberg-io/xberg/blob/main/packages/go/README.md

Clones the repository, builds the static library with cargo, copies it to a permanent location, and builds a Go project with CGO_LDFLAGS.

```bash
# Clone the repository
git clone https://github.com/xberg-io/xberg.git
cd xberg

# Build the static library
cargo build -p xberg-ffi --release

# The static library is now at: target/release/libxberg_ffi.a
# Copy it to a permanent location
mkdir -p ~/xberg/lib
cp target/release/libxberg_ffi.a ~/xberg/lib/

# Now you can build Go projects
cd ~/my-go-project
CGO_LDFLAGS="-L$HOME/xberg/lib -lxberg_ffi" go build
```

--------------------------------

### List validators with listValidators

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/snippets-generated/typescript/plugin_api/validators_list.md

Use `listValidators` from `@xberg-io/xberg` to get all registered validators. The function returns a result that is logged to the console. This example is safe and has no side effects.

```TypeScript
import { listValidators } from "@xberg-io/xberg";
function main() {
  const result = listValidators();
  console.log(result);
}

void main();
```

--------------------------------

### Embed with LLM provider

Source: https://github.com/xberg-io/xberg/blob/main/plugin/skills/extracting-keywords/SKILL.md

Use --provider llm to get provider-hosted embeddings via an LLM. Requires --model and --api-key. Example uses openai/text-embedding-3-small.

```bash
# Provider-hosted embeddings via an LLM
xberg embed --text "query text" \
  --provider llm --model openai/text-embedding-3-small --api-key "$OPENAI_API_KEY"
```

--------------------------------

### PostProcessor.ShouldProcess signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

The ShouldProcess method signature and an example call that passes empty document and config values and assigns the boolean result.

```go
func (o *PostProcessor) ShouldProcess(result ExtractedDocument, config ExtractionConfig) bool
```

```go
result := instance.ShouldProcess(ExtractedDocument{}, ExtractionConfig{})
```

--------------------------------

### xberg_document_extractor_priority() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-c.md

Get the priority of this extractor. Higher priority extractors are preferred when multiple extractors support the same MIME type. Returns the priority value (default: 50).

```c
int32_t xberg_document_extractor_priority(XBERGAlefHandle this);
```

```c
int32_t result = xberg_document_extractor_priority(instance);
```

--------------------------------

### Registry.global() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-elixir.md

Signature and example for returning the global registry, loading it on first access. Panics if any embedded preset is malformed.

```elixir
def global()
```

```elixir
{:ok, result} = Registry.global()
```

--------------------------------

### xberg_document_extractor_supported_mime_types() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-c.md

Get the list of MIME types supported by this extractor. Can include exact MIME types and prefix patterns. Returns a slice of MIME type strings.

```c
const char* xberg_document_extractor_supported_mime_types(XBERGAlefHandle this);
```

```c
const char* result = xberg_document_extractor_supported_mime_types(instance);
```

--------------------------------

### xberg_plugin_initialize() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-c.md

Signature and example for the xberg_plugin_initialize method. Called once during registration; returns 0 on success, -1 on error. Defaults to a no-op for stateless plugins.

```c
int32_t xberg_plugin_initialize(XBERGAlefHandle this);
```

```c
xberg_plugin_initialize(instance);
```

--------------------------------

### Install ONNX Runtime (Ubuntu/Debian)

Source: https://github.com/xberg-io/xberg/blob/main/packages/python/README.md

Provides installation guidance for ONNX Runtime on Ubuntu/Debian, noting that Debian packages may be older and recommending downloading from GitHub releases.

```bash
# Ubuntu/Debian (download from GitHub - Debian packages may have older versions)
# Download from https://github.com/microsoft/onnxruntime/releases
```

--------------------------------

### DoctorCheckFail: Create a Fail Verdict

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

Creates a DoctorCheck with ProbeStatus.Fail, indicating the configured setup will not work or will silently degrade on this host. The example shows the function signature and a sample call.

```go
func DoctorCheckFail(name string, message string) *DoctorCheck
```

```go
result := DoctorCheckFail("value", "value")
```

--------------------------------

### Start services with docker compose up -d

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/integrations/openwebui.mdx

Starts both services in detached mode after the docker-compose.yaml is in place. Then open http://localhost:3000, create an account, and upload a document.

```bash
docker compose up -d
```

--------------------------------

### Registry#sample_bytes example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-ruby.md

Example call to read sample bytes. Both preset_id and name are required Strings. Returns a String? (nil if file absent).

```ruby
result = instance.sample_bytes("value", "value")
```

--------------------------------

### Install from source (path)

Source: https://github.com/xberg-io/xberg/blob/main/crates/xberg-cli/README.md

Installs xberg-cli from the local source path.

```bash
cargo install --path crates/xberg-cli
```

--------------------------------

### validate_language_code() signature and example

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-rust.md

Validates a Tesseract language code (or +-separated list). Accepts "all" and "*" as special values that auto-detect installed languages. Returns OcrError::InvalidLanguageCode if any component is not in the supported set.

```rust
pub fn validate_language_code(lang_code: &str) -> Result<(), OcrError>
```

```rust
validate_language_code("value")?;
```

--------------------------------

### Calling Plugin Version()

Source: https://github.com/xberg-io/xberg/blob/main/docs-site/src/content/docs/reference/api-go.md

Example call to the Version method, returning the plugin's version as a string.

```go
result := instance.Version()
```
Tokens:
Raw