groundero 0.1.0

Visual grounding search for academic papers with Zotero integration

Groundero

Visual grounding search for papers with Zotero integration and RAG-based question answering.

Installation

Prerequisites

• Python 3.11+
• uv package manager
• Zotero desktop app (running locally)
• Google AI Studio API key

Recommended

• Better BibTeX plugin for Zotero
• All items should have pinned citation keys (stored in the Extra field) for best results, auto-generated keys will be used as fallback for UI display.

Setup

Install

uv tool install groundero

Development Install

uv sync

2. Setup and build database:

groundero

Usage

Commands

• groundero - Interactive query mode
• groundero setup - Initial setup and database build
• groundero update [--limit N] - Update database from Zotero
• groundero query "question" - Ask a single question
• groundero list - List indexed documents
• groundero help - Show help

Examples

groundero update

# Ask questions about your papers
groundero query "Why are PINNs hard to train"

# Interactive mode for multiple queries
groundero

Configuration

Environment is configured during groundero setup - no manual .env file needed.

Zotero Local API Setup

Required: Groundero currently only works with local Zotero. Make sure the local API is enabled:

1. Open Zotero
2. Go to: Settings → Advanced → Config Editor
3. Set extensions.zotero.httpServer.localAPI.enabled to true
4. Restart Zotero

Without this setting, Groundero won't be able to connect to your local Zotero library.