Skip to content
BranchesTags

Repository files navigation

Haven CLI

Snyk Vulnerabilities

Decentralized video archival with AI-powered analysis and blockchain verification.

Features

  • 📹 Video Archival: Archive videos from YouTube, local files, and more
  • 🔐 Encryption: Haven-AOL access-controlled encryption
  • 🗄️ Decentralized Storage: Filecoin/IPFS via Synapse
  • 🤖 AI Analysis: VLM-powered timestamp and tag generation
  • ⛓️ Blockchain Sync: Arkiv on-chain metadata records
  • 🔌 Plugin System: Extensible archiver plugins
  • ⏰ Scheduling: Cron-based automated archival

Quick Start

Installation

pip install haven-cli

Configuration

haven config init

Upload a Video

haven upload video.mp4

Start Daemon

haven run

Launch TUI (Optional)

# Start the Terminal User Interface for real-time monitoring
haven-tui

Data Format Standardization

haven-cli now uses the Haven Cross-Application Data Format, ensuring full compatibility with:

  • haven-player (Gold Standard)
  • haven-dapp

Key Field Names

When working with Arkiv entities created by haven-cli:

Payload Fields (Private):

  • filecoin_root_cid - The Filecoin CID for video content
  • is_encrypted - Boolean indicating encryption status
  • cid_hash - SHA256 hash of the CID
  • vlm_json_cid - CID of VLM analysis JSON
  • encryption_metadata - JSON string of encryption metadata
  • segment_metadata - Multi-segment recording info

Attributes Fields (Public):

  • title - Video title
  • is_encrypted - Integer 0 or 1
  • cid_hash - SHA256 hash of CID
  • created_at - ISO8601 timestamp
  • updated_at - ISO8601 timestamp
  • creator_handle - Content creator
  • mint_id - NFT mint identifier
  • analysis_model - VLM model used

For detailed format documentation, see Arkiv Data Format and Migration Notes.

Documentation

Haven CLI

Haven TUI

Requirements

  • Python 3.11+
  • FFmpeg (for video processing)
  • Deno 1.40+ (for JS runtime)
  • yt-dlp (for YouTube plugin)

Installation

From PyPI

pip install haven-cli

From Source

git clone https://github.com/haven/haven-cli
cd haven-cli
pip install -e .

Development Installation

git clone https://github.com/haven/haven-cli
cd haven-cli
pip install -e ".[dev]"

Quick Command Reference

Command Description
haven config init Initialize configuration
haven config show Show current configuration
haven upload <file> Upload a video file
haven download <cid> Download a file by CID
haven jobs list List scheduled jobs
haven jobs create --plugin <name> --schedule <cron> Create a scheduled job
haven plugins list List available plugins
haven plugins enable <name> Enable a plugin
haven plugins test <name> Test a plugin
haven run Start the daemon
haven run status Check daemon status
haven run stop Stop the daemon

Pipeline Overview

The Haven pipeline processes videos through these steps:

┌─────────┐   ┌─────────┐   ┌─────────┐   ┌────────┐   ┌──────┐
│ Ingest  │──▶│ Analyze │──▶│ Encrypt │──▶│ Upload │──▶│ Sync │
└─────────┘   └─────────┘   └─────────┘   └────────┘   └──────┘
  1. Ingest: Extract metadata, calculate pHash, check duplicates
  2. Analyze: Run VLM to generate timestamps and tags (optional)
  3. Encrypt: Encrypt with Haven-AOL (optional)
  4. Upload: Store on Filecoin via Synapse (optional)
  5. Sync: Record metadata on Arkiv blockchain (optional)

Configuration

Configuration is stored in ~/.config/haven/config.toml:

[pipeline]
vlm_enabled = true
encryption_enabled = true
upload_enabled = true
sync_enabled = true

[scheduler]
enabled = true

[js_runtime]
runtime = "deno"

See Configuration Reference for all options.

Environment Variables

All configuration can be overridden via environment variables:

export HAVEN_VLM_ENABLED=true
export HAVEN_SYNAPSE_API_KEY=your-key
export HAVEN_LOG_LEVEL=DEBUG

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Type checking
mypy haven_cli

# Linting
ruff check haven_cli

# Format code
ruff format haven_cli

Architecture

┌─────────────────────────────────────────────────────────────┐
│                        HAVEN CLI                             │
│                                                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   Upload    │  │  Download   │  │   Job Scheduler     │  │
│  │   Command   │  │   Command   │  │   (Cron-based)      │  │
│  └──────┬──────┘  └──────┬──────┘  └──────────┬──────────┘  │
│         │                │                    │             │
│         └────────────────┴────────────────────┘             │
│                              │                              │
│                              ▼                              │
│  ┌─────────────────────────────────────────────────────┐   │
│  │                   Pipeline Engine                    │   │
│  │  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌────────┐  │   │
│  │  │ Ingest  │→│ Analyze │→│ Encrypt │→│ Upload │  │   │
│  │  └─────────┘  └─────────┘  └─────────┘  └────────┘  │   │
│  └─────────────────────────────────────────────────────┘   │
│                              │                              │
│         ┌────────────────────┼────────────────────┐         │
│         ▼                    ▼                    ▼         │
│  ┌─────────────┐      ┌─────────────┐      ┌─────────────┐  │
│  │   Plugin    │      │ Haven-AOL/  │      │  Synapse/   │  │
│  │   System    │      │   Arkiv     │      │  Filecoin   │  │
│  └─────────────┘      └─────────────┘      └─────────────┘  │
└─────────────────────────────────────────────────────────────┘

License

MIT

Contributing

Contributions are welcome! Please see our Contributing Guide for details.

Support

Useful links

About

Reclaiming the Internet for the User.

Resources

Readme
Activity
Custom properties

Stars

1 star

Watchers

1 watching

Forks

1 fork
Report repository

Releases

Packages

Used by

Contributors

Languages