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.3.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.3.0
File	Size	Uploaded
unb_consultant-0.3.0.tar.gz	39.7 kB	Jul 26, 2026	Details

Built distribution (wheel)

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

Total release size: 79.9 kB

Release files / unb_consultant-0.3.0.tar.gz

Download URL	unb_consultant-0.3.0.tar.gz
Size	39.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`efc3ba98352c1e1cdb6a71a8136b4f38faf2e5bf7d19b7575f2b1cf6604507c1`
BLAKE2b-256 checksum How to use checksums	`d7b48b5a437f6b9a5e1dd37fce48173fccdd3795fced76a36e0a806e5f72ceb6`
Upload date	Jul 26, 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/d377c4c9966efc189d19dfd687ae5ecbc6360d60

Workflow

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

Artifact

Subject: unb_consultant-0.3.0.tar.gz
SHA-256 checksum: efc3ba98352c1e1cdb6a71a8136b4f38faf2e5bf7d19b7575f2b1cf6604507c1 Verifying attestations

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

Download URL	unb_consultant-0.3.0-py3-none-any.whl
Size	40.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`77484e854293ce68b90674846799b3b3955e7f7face258cec3982d53b6890482`
BLAKE2b-256 checksum How to use checksums	`7c77603635af9cad57ee321fd70242b7380b34fc706ef76adf6d512b66ac2855`
Upload date	Jul 26, 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/d377c4c9966efc189d19dfd687ae5ecbc6360d60

Workflow

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

Artifact

Subject: unb_consultant-0.3.0-py3-none-any.whl
SHA-256 checksum: 77484e854293ce68b90674846799b3b3955e7f7face258cec3982d53b6890482 Verifying attestations