Install‑Bridge

Semantic Ingestion Engine for the Semantic Dropdown Search API

Install‑Bridge 3.0.0 is a fully‑typed Python CLI that serves as the ingestion gateway for the Semantic Dropdown Search API (v2.0.0).

It transforms media and creative artifacts—YouTube videos, images, articles, audio, and Pinterest boards—into deterministic semantic descriptors and optional embeddings.

Install‑Bridge is the foundation of a semantic creation platform, enabling cross‑modal indexing and search.

---

Philosophy

• Lightweight & Developer‑Friendly — Built on Typer for intuitive CLI ergonomics.
• Deterministic‑First — Rule‑based descriptor generation powered by spaCy ensures reproducibility.
• Optional Embeddings — CPU‑only support for sentence‑transformers and CLIP, configurable via global settings.
• Seamless Integration — Native client for POSTing ingestion payloads to the /semantic-index endpoint.

---

Installation

Install‑Bridge uses Poetry for dependency management.

git clone https://github.com/dfeen87/Install-Bridge/
cd Install-Bridge
poetry install

Run the CLI:

poetry run bridge

To use globally, install the wheel or alias the command.

---

Configuration

Install‑Bridge stores settings in your global user configuration directory
(e.g., ~/.config/install-bridge/config.json).

Show current configuration:

bridge config show

Set configuration values:

bridge config set use_embeddings true
bridge config set api_url http://your-semantic-api.com:8000

Available Keys

• api_url
• use_embeddings (true/false)
• embedding_model
• image_model
• audio_model
• log_level

---

Ingestion Commands

Each ingestion module extracts metadata, generates deterministic descriptors, optionally computes embeddings, and sends a unified payload to the Semantic API.

YouTube

bridge ingest youtube <url>

Pinterest (Mocked extraction for now)

bridge ingest pinterest <board_url>

Image

bridge ingest image <file_or_url>

Article

bridge ingest article <url>

Audio

bridge ingest audio <file_or_url>

---

Extending Descriptors

Install‑Bridge supports proprietary semantic rules via:

install_bridge/descriptors/proprietary_rules.py

You can inject custom heuristics for any ingestion module, enabling domain‑specific semantic enrichment.