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.1

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.1
File	Size	Uploaded
unb_consultant-0.3.1.tar.gz	40.0 kB	Jul 26, 2026	Details

Built distribution (wheel)

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

Total release size: 80.4 kB

Release files / unb_consultant-0.3.1.tar.gz

Download URL	unb_consultant-0.3.1.tar.gz
Size	40.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`362c4802244d66014e3069d6317132c513377dc702f09e42d3bdecad4a51e20a`
BLAKE2b-256 checksum How to use checksums	`04e3e615f3aa4324179ecf3243ad4406100f422e09edc1aacd19e01742364e20`
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/c1ba5aa2585ccb0513f0867c99639cb7c9e82926

Workflow

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

Artifact

Subject: unb_consultant-0.3.1.tar.gz
SHA-256 checksum: 362c4802244d66014e3069d6317132c513377dc702f09e42d3bdecad4a51e20a Verifying attestations

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

Download URL	unb_consultant-0.3.1-py3-none-any.whl
Size	40.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`bdc4a976b3d2338be5cb7b53f164480cee25d70b1d2b8cedc051c7fd9e2e77d8`
BLAKE2b-256 checksum How to use checksums	`8904565d65821fa29ef411b610de8c559e2b4605dfc1fb7b3cafd602e86ec014`
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/c1ba5aa2585ccb0513f0867c99639cb7c9e82926

Workflow

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

Artifact

Subject: unb_consultant-0.3.1-py3-none-any.whl
SHA-256 checksum: bdc4a976b3d2338be5cb7b53f164480cee25d70b1d2b8cedc051c7fd9e2e77d8 Verifying attestations