Vio File (.vio)

The patent-pending declarative contract for AI infrastructure.

.vio is the source of truth for your AI systems. It captures prompts, skills, memory, models, agents, connectors, policies, and observability: human-readable, versioned, and environment-aware.

Join the waitlist →

research-analyst.vioYAML · SIGNED

manifest:
  name: Research Analyst System
  version: 1.0.0
  description: Agent for research,
    synthesis and reporting
  author: data-architect
  created: 2025-05-18
  contract_version: 1.0

frameworks:
  - crewai
  - langgraph
  - adk

assets:
  prompts:       /prompts/
  skills:        /skills/
  memory:        /memory/
  policies:      /policies/
  observability: /observability/

models:
  default:   openai:gpt-4o
  reasoning: anthropic:claude-3.5-sonnet
  embedding: openai:text-embedding-3-large

connectors:
  - name: vector_db
    env:
      VECTOR_DB_URL:     ${VECTOR_DB_URL}
      VECTOR_DB_API_KEY: ${VECTOR_DB_API_KEY}
  - name: search_api
    env:
      SEARCH_API_KEY:    ${SEARCH_API_KEY}

signing:
  algorithm: ed25519
  signer:    viorant-ci
  signature: a1b2c3d4...97fe

targets: [local, docker, cloud, self-hosted]

Framework-agnostic

Works across frameworks like CrewAI, LangGraph, ADK, and more.

Multi-model management

Best-fit models per capability and cost.

Signed artifacts

Cryptographically signed & verifiable.

Provenance chain

Full lineage and change history.

Connectors via env vars

Secure, portable integrations.

Run on any infra

Local, cloud, or self-hosted.

From scattered AI assets to one governed contract.

THE PROBLEM

Scattered prompts, skills, memory, and tools

Assets live in docs, code, and wikis, hard to find, reuse, and trust.

Local-to-prod drift

Different configs and models between environments create risk.

No signing or provenance

Changes aren't tracked, signed, or attributable.

Framework and cloud lock-in

Tied to one stack or provider, making portability impossible.

Hard to review AI stacks

Complex, non-standard configs are difficult to read and audit.

⇢

THE VIO FILE SOLUTION

One declarative file

Everything in one place. Human-readable. Versioned. Verifiable.

Same contract from local to target

Environment-aware config keeps behavior consistent everywhere.

Signed artifacts and traceable lineage

Cryptographic signing plus provenance for audits and compliance.

Portable across frameworks and clouds

Run on Helix, LangGraph, CrewAI, or any target, your choice.

Human-readable and reviewable

Easy to diff, review, and reason about AI systems.

One file. Complete control.

Prompts

System, user, and agent prompts.

Skills

Functions, tools, and capabilities.

Memory

Vector stores, RAG and state.

Models

Any model, any provider.

Agents

Behavior, routing, and orchestration.

Policies

Guardrails, approvals, and access control.

Observability

Logs, traces, metrics, and alerts.

How .vio fits the operating layer.

One contract. Many environments. Clear responsibilities.

1HUB AUTHORS

Author and manage .vio contracts in a secure, local-first workspace. Validate, lint, and sign before handoff.

→

2.VIO DESCRIBES

The patent-pending declarative contract for AI infrastructure. Defines agents, prompts, models, policies, connectors, and observability.

→

3HELIX DEPLOYS

Resolves dependencies, applies policies, builds and packages, then deploys the contract to any infrastructure.

→

4ANY INFRASTRUCTURE

Your choice of deployment targets. Bring your own or use managed options.

✓ Any cloud✓ On-prem✓ Edge✓ Local✓ Self-hosted

SUPPORTING LAYERS

Vio Infra (available in August)

Managed infrastructure option for running workloads. Pre-configured, hardened, and maintained by Viorant.

Sentinel

Observability, security, and control panel for deployed assets. Monitor, investigate, and enforce with confidence.

DEPLOYMENT TARGETS

Any cloud On-prem Edge Local Self-hosted

Built for engineers. Designed for trust.

Human-readable

Clear, declarative, and easy to review.

Auditable

Every decision can be explained and verified.

Governed

Policies, approvals, and guardrails built in.

Portable

Run anywhere with the same contract.

Signed artifacts

Cryptographically signed and verifiable.

Modules & registry

Reusable modules with versioning and lineage.

Environment-variable secrets

No secrets in code. Secure by design.

Observability declared

Logs, traces, metrics, and alerts defined up front.

Multi-framework + multi-model management.

One declarative file. Any framework. Best-fit models.

FRAMEWORKS

⬡ CrewAI⬡ LangGraph⬡ ADK+ More frameworks

VIO FILE (.VIO)

System definitionAgents and skillsMemory and connectorsPolicies and observability

MODELS & PROVIDERS

◆ OpenAI◆ Anthropic◆ Llama◆ Gemini+ More providers

How it works.

Declare the system

Define agents, tools, memory, models, policies, and observability in .vio.

⇢

Version and sign assets

Artifacts and modules are versioned and cryptographically signed.

⇢

Helix resolves dependencies and policies

Helix resolves dependencies and validates policies.

⇢

Run anywhere with the same contract

Deploy and operate consistently across any environment.

Questions, answered.

01What is .vio?+

The patent-pending declarative contract for AI infrastructure. It defines everything needed to build, deploy, and operate AI systems, prompts, skills, memory, models, policies, connectors, and observability, in one portable file.

02Does it lock me into Viorant?+

No. .vio is portable and designed to remain useful without Viorant.

03How is Hub different from Helix?+

Hub is the authoring workspace for creating and validating .vio contracts. Helix is the deployment engine that resolves dependencies and deploys the contract to any infrastructure.

04What is Vio Infra?+

Vio Infra is our managed infrastructure option for running workloads.

05What is Sentinel?+

Sentinel is the observability, security, and control panel for deployed assets. Monitor, investigate, and enforce with confidence.

06How does signing work?+

Assets and contracts are cryptographically signed to ensure integrity, provenance, and non-repudiation.

07Can I run on my own infrastructure?+

Yes. .vio deploys to any cloud, on-prem, edge, local, or self-hosted environment you choose.

Vio File (.vio) is patent-pending
and built for portable AI infrastructure.

The source of truth for every AI system you build.

Join the waitlist →Talk to us →

Civilize intelligence.