Skip to main content

ContextBase Onboarding Service

Ingest, process, and package organizational context for AI assistants.

context-onboard extracts knowledge from your team's existing tools and surfaces it as structured knowledge graphs, ready-to-use system prompts for Claude/GPT/Gemini, and beautiful HTML reports.

Features

  • 🔌 Multi-source ingestion — Slack, Email (IMAP), Google Drive, Airtable
  • 🧠 Knowledge graph — Deduplicates entities, merges relationships, computes statistics
  • 📝 AI prompts — Generates system prompts for Claude, GPT-4, and Gemini
  • 🎁 Deliverable packaging — Creates ZIP archives with graph JSON, prompts, and HTML reports
  • 🔧 MCP-style config — Tool-use configuration for Model Context Protocol

Quick Start

# Install
pip install context-onboard

# With all extras
pip install "context-onboard[all]"

Usage

1. Ingest — Pull data from your sources

Create a config file (config.yaml):

output_dir: ./data
ingestors:
  slack:
    token: xoxb-your-bot-token
    enabled: true
  email:
    host: imap.gmail.com
    username: user@gmail.com
    password: "app-password"
    max_messages: 200
    enabled: true
  drive:
    token:
      token: ya29...
      refresh_token: 1//...
    max_files: 100
    enabled: true
  airtable:
    api_key: patXXXX...
    base_ids:
      - appXXXX1
    enabled: true

Then run:

context-onboard ingest --config config.yaml

2. Build — Generate knowledge graph and prompts from existing data

context-onboard build --data ./data --company "Acme Corp" --output ./output

3. Package — Create a deliverable ZIP

context-onboard package --data ./output --output ./deliverable --company "Acme Corp"

Architecture

context_onboard/
├── __init__.py              # Package init, version 0.1.0
├── models.py                # Core data models (Entity, Relationship, ContextPackage)
├── cli.py                   # CLI entry point (argparse)
├── ingestors/
│   ├── base.py              # BaseIngestor ABC
│   ├── slack.py             # SlackIngestor (slack_sdk)
│   ├── email.py             # EmailIngestor (imaplib — stdlib)
│   ├── drive.py             # GoogleDriveIngestor (google-api-python-client)
│   └── airtable.py          # AirtableIngestor (requests)
├── processors/
│   ├── knowledge_graph.py   # Deduplication, merging, graph stats
│   └── prompt_library.py    # Claude, GPT, Gemini prompt generation + MCP config
└── output/
    └── package.py           # ZIP packaging + HTML report generation

Data Models

Model Description
EntityType Enum: PERSON, TEAM, PROJECT, DOCUMENT, TOOL, PROCESS, GLOSSARY_TERM
Entity A node in the context graph (id, name, type, description, metadata)
Relationship A typed, weighted edge between two entities (0-1 strength)
ContextPackage A complete snapshot from one ingest source or the merged graph

Optional Dependencies

Feature Install command
Slack pip install "context-onboard[slack]"
Google Drive pip install "context-onboard[google]"
Airtable pip install "context-onboard[airtable]" (requests included by default)
YAML config pip install "context-onboard[yaml]"
All pip install "context-onboard[all]"

Email ingestor uses stdlib only (imaplib, email) — no extra deps needed.

Development

git clone https://github.com/contextbase/context-onboard.git
cd context-onboard
pip install -e ".[dev]"
pytest

License

MIT

Release files for context-onboard 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for context-onboard 0.1.0
File Size Uploaded
context_onboard-0.1.0.tar.gz 27.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for context-onboard 0.1.0
File Interpreter ABI Platform
context_onboard-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 60.3 kB

Release files / context_onboard-0.1.0.tar.gz

Download URL context_onboard-0.1.0.tar.gz
Size 27.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a707988fb00fc26b4add83f8ec4df72867f3a4583cb5e59ac217d4e0d3b149d2
BLAKE2b-256 checksum
How to use checksums
33aea84226bd39b6248fc2d5ebe70593a7e26034d94b22fc0d5fc59654eb879c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release files / context_onboard-0.1.0-py3-none-any.whl

Download URL context_onboard-0.1.0-py3-none-any.whl
Size 32.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2651e0bb449899b16637940d8f7843e20397871cb9bd827d0ce03debfc7991d1
BLAKE2b-256 checksum
How to use checksums
a9ee4be21b29229e803067412c846b96fa31b59ccec5db53bd37be2c2d183d4f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page