unb-consultant

Universal NotebookLM-Based Consultant. Create and query AI experts powered by Google Gemini Notebook (formerly NotebookLM).

Installation

pipx install "unb-consultant[browser]"

Or with cookie extraction support:

pipx install "unb-consultant[browser,cookies]"

Quick Start

# Authenticate
unb login

# Create an expert
unb expert create "cvss-v4" \
  --url "https://www.first.org/cvss/v4-0/specification-document" \
  --desc "CVSS v4.0 scoring expert"

# Ask a question
unb ask "cvss-v4" "How is the base score calculated?"

# List experts
unb expert list

MCP Server

For AI agent integration, start the MCP server:

unb mcp

Then configure in your opencode.json:

{
  "mcpServers": {
    "unb-consultant": {
      "command": "unb",
      "args": ["mcp"]
    }
  }
}

Commands

Command	Description
`unb login`	Authenticate with Google
`unb auth check --test`	Verify authentication
`unb auth refresh`	Refresh authentication tokens
`unb expert create NAME`	Create a new expert (`--url`, `--file`, `--auto`)
`unb expert list`	List all experts (`--json` for structured output)
`unb expert delete NAME`	Delete an expert (`--yes` to skip confirmation)
`unb ask NAME QUESTION`	Ask a question (`--json` for citations)
`unb suggest KEYWORD ...`	Suggest expert domains by keywords
`unb catalog NAME`	Generate thematic catalog
`unb skill-gen NAME`	Generate SKILL.md (`--auto` for automatic)
`unb source add NAME`	Add sources to expert
`unb init`	Set up unb-consultant in a project (`--auto`)
`unb setup`	Interactive setup wizard
`unb mcp`	Start MCP server

Development

Prerequisites

Python 3.10+
Google account (for NotebookLM)

Local setup

git clone https://github.com/freddyeleazar/unb-consultant.git
cd unb-consultant
pip install -e ".[browser,dev]"

Testing

pytest

Releasing

See AGENTS.md for the release workflow. The project uses Conventional Commits and Keep a Changelog.

Metadata

Release files for unb-consultant 0.4.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 unb-consultant 0.4.0
File	Size	Uploaded
unb_consultant-0.4.0.tar.gz	40.6 kB	Jul 27, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for unb-consultant 0.4.0
File	Interpreter	ABI	Platform	Reset
unb_consultant-0.4.0-py3-none-any.whl 40.8 kB Jul 27, 2026	Python 3	none	any	Details

Total release size: 81.4 kB

Release files / unb_consultant-0.4.0.tar.gz

Download URL	unb_consultant-0.4.0.tar.gz
Size	40.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`b1a017f8d51db20edcb5c065c675731c1300cf14378478a269d83d7308113a28`
BLAKE2b-256 checksum How to use checksums	`ff83882b6feb6d99604a983dc8cd61413f46e3bb6197d4d7447a5632589b4232`
Upload date	Jul 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/freddyeleazar/unb-consultant
Publishing commit: github.com/freddyeleazar/unb-consultant/tree/6d32ff10b5e9e1abe6cb0d9383f6fcaf1a3a3a5e

Workflow

Publishing configuration: github.com/freddyeleazar/unb-consultant/blob/6d32ff10b5e9e1abe6cb0d9383f6fcaf1a3a3a5e/.github/workflows/publish.yml
Publishing logs: github.com/freddyeleazar/unb-consultant/actions/runs/30307399307/attempts/1

Artifact

Subject: unb_consultant-0.4.0.tar.gz
SHA-256 checksum: b1a017f8d51db20edcb5c065c675731c1300cf14378478a269d83d7308113a28 Verifying attestations

Release files / unb_consultant-0.4.0-py3-none-any.whl

Download URL	unb_consultant-0.4.0-py3-none-any.whl
Size	40.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c97e069d3eb34cc34c821121b78cea9b1b65dc954f2ff9db01d3418b71816ab1`
BLAKE2b-256 checksum How to use checksums	`4b1e2809444d43f2345f47c50140165529bba2d45328f1735e04e7d9a7a43b14`
Upload date	Jul 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/freddyeleazar/unb-consultant
Publishing commit: github.com/freddyeleazar/unb-consultant/tree/6d32ff10b5e9e1abe6cb0d9383f6fcaf1a3a3a5e

Workflow

Publishing configuration: github.com/freddyeleazar/unb-consultant/blob/6d32ff10b5e9e1abe6cb0d9383f6fcaf1a3a3a5e/.github/workflows/publish.yml
Publishing logs: github.com/freddyeleazar/unb-consultant/actions/runs/30307399307/attempts/1

Artifact

Subject: unb_consultant-0.4.0-py3-none-any.whl
SHA-256 checksum: c97e069d3eb34cc34c821121b78cea9b1b65dc954f2ff9db01d3418b71816ab1 Verifying attestations