Welcome to the vCon Super Repository — the central hub for all vCon (Virtual Conversation) development projects. This repository tracks all 61 repos in the vcon-dev GitHub organization as git submodules, giving you a single checkout of the entire ecosystem.
vCon (Virtual Conversation) is an open standard for conversation data that defines how human conversations can be shared, analyzed, and secured. Think of it as "PDFs for human conversations" — a standardized format capturing audio, transcripts, metadata, and analysis.
- IETF spec: draft-ietf-vcon-vcon-core
- Ecosystem overview: vcon-dev.github.io
| Submodule | Description |
|---|---|
| vcon-lib | Python vCon library — reference implementation, vCon 0.4.0 spec |
| vcon-js | TypeScript/JavaScript vCon library — vCon core-02 spec |
| pydantic-vcon | Pydantic v2 models for vCon |
| Submodule | Description |
|---|---|
| vcon-server | The Conserver — main vCon processing and storage platform |
| vcon-server-cli | CLI for managing and interacting with vcon-server |
| vcon-mcp | Model Context Protocol server for vCon data |
| mongo-redis-sync | MongoDB ↔ Redis sync service for vCon storage |
| vcon-s3-loader | S3 batch loader for vCon files |
| load_test | Load testing tools for vcon-server |
| Submodule | Description |
|---|---|
| vcon-telephony-adapters | Umbrella repo for all telephony adapters |
| vcon-siprec-adapter | SIP Recording (SIPREC) adapter |
| sippy-conserver-adapter | Sippy B2BUA adapter for vcon-server |
| signalwire_adapter | SignalWire telephony adapter |
| vcon-audio-adapter | Generic audio file adapter |
| vcon-fadapter | File adapter for batch vCon import |
| matrix_vcon_emitter | Matrix protocol vCon emitter |
| Submodule | Description |
|---|---|
| whisper | OpenAI Whisper integration for vCon transcription |
| TTS | Text-to-speech integration |
| speechmatics-link | Speechmatics transcription adapter |
| vcon-eleven-labs-adapter | ElevenLabs TTS adapter |
| vcon-mac-wtf | macOS World Transcription Format client |
| wtf-server | WTF (World Transcription Format) server |
| wtf-transcript-converter | Converter between WTF and other transcript formats |
| conversational_search | Semantic search over vCon data |
| langchain | LangChain integration for vCon |
| conversation-gpt | ChatGPT over vCon data via Elasticsearch |
| Submodule | Description |
|---|---|
| vcon-admin | Streamlit-based admin dashboard |
| vcon-app-template | Starter template for vCon applications |
| vcon-speckit | Tools for working with the vCon spec |
| vcon-desk-viewer | Desktop vCon viewer application |
| vscode-vcon-viewer | VS Code extension for viewing vCon files |
| vcon-laptop | Laptop-local vCon capture tools |
| scitt-action | GitHub Action for SCITT ledger registration |
| scittles | SCITT utilities for vCon transparency |
| ietf2vcon | Convert IETF meeting recordings to vCon |
| modelcontextprotocol | MCP protocol tools for vCon |
| vcon-sample-link | Sample link resolver for vCon references |
| vcon-zip | vCon zip/bundle utilities |
| tadhack-2025 | TADHack 2025 hackathon projects |
| Submodule | Description |
|---|---|
| vcon-right-to-know | GDPR right-to-access and right-to-forget demo |
| Submodule | Description |
|---|---|
| vcon-faker | Synthetic vCon generator using OpenAI |
| fake-vcons | Sample/synthetic vCon files for testing |
| ietf-meeting-vcons | vCons from IETF meeting recordings |
| vcon-the-hacks | Hackathon and experimental vCon projects |
| Submodule | Description |
|---|---|
| draft-howe-vcon-wtf-extension | World Transcription Format extension for vCon |
| draft-howe-vcon-sip-signaling | SIP signaling extension for vCon |
| draft-howe-vcon-lawful-basis | Lawful basis extension for vCon |
| draft-howe-vcon-lifecycle | vCon lifecycle management draft |
| draft-howe-sipcore-mcp-extension | SIP core MCP extension draft |
| draft-ietf-vcon-privacy-primer | Privacy considerations for vCon |
| draft-ietf-vcon-vcon-overview | vCon ecosystem overview draft |
| Submodule | Description |
|---|---|
| docs | Developer documentation site (Mintlify) |
| vcon-docs | Additional vCon documentation |
| vcon-info | Informational resources about vCon |
| vcon-background-docs | Background reading and research |
| awesome-vcon | Curated list of vCon tools and resources |
| vcon-dev.github.io | vcon-dev GitHub Pages site |
| Submodule | Description |
|---|---|
| homebrew-tap | Homebrew tap — index of vCon Homebrew formulas |
| homebrew-vcon | Homebrew formula for the vCon CLI tools |
| Submodule | Description |
|---|---|
| pyVoIP | Fork of pyVoIP with vCon integration |
| rd-apmm-python-lib-rtp | Fork of RTP library for vCon audio |
Clone with all submodules:
git clone --recursive https://github.com/vcon-dev/vcon.git
cd vconOr initialize submodules in an existing clone:
git submodule update --init --recursiveUpdate all submodules to latest:
git submodule update --remote --recursiveUpdate a single submodule:
git submodule update --remote vcon-serverThe tools/ directory contains local utilities:
update-submodules.sh— shell script to pull all submodules to latestpostgres_schema.sql— PostgreSQL schema for vcon-server storageembed_streamlit_demo.html— iframe embed snippet for Streamlit app demos
The assets/docs/ directory contains standalone reference documents:
- What is a vCon (PDF)
- vCons: an Open Standard for Conversation Data (PDF)
- Communications Design diagram
A GitHub Action runs every Monday at 9 AM UTC, updates all submodules to their latest commits, and opens a pull request with the changes for review.
MIT — see LICENSE for details.