What makes Calibre Ebooks notable?

1.3K downloads. Trust evidence available

How should Calibre Ebooks be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Calibre Ebooks

calibre-ebooks is an OpenClaw skill for querying and operating a local Calibre library through a local Books API and helper scripts. It works only with books already available in the configured Calibre library and does not download, search, or add books from external sources. The project includes agent workflow guidance, a Python API client, a FastAPI server, semantic RAG support, systemd services, and local environment-based configuration.

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.3k

Updated

Oct 10, 2026

Version

1.0.12

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.3K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.12release · observed Jun 20, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s170b1fz655f17dk9t1c1q35rn877cxx:calibre-ebooks

Install using `clawhub skill install s170b1fz655f17dk9t1c1q35rn877cxx:calibre-ebooks` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/carlosdelfino/calibre-ebooks before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-carlosdelfino-calibre-ebooks/snapshot"

Documentation

CLAWHUB

160,000 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: calibre-ebooks
description: Manage and query the local Calibre library through the Books API, using local Calibre/RAG helpers only when file resolution or semantic indexing is explicitly needed.
metadata: '{"openclaw":{"requires":{"bins":["python3"]}}}'
homepage: https://github.com/carlosdelfino/openclaw-skill-calibre-ebooks
---
# Calibre E-books

Location: `/skills/calibre-ebooks/SKILL.md` from the OpenClaw workspace root.

Use this skill only to manage and query the local Calibre-backed Books API and,
when needed, prepare books that already exist in the local Calibre library for
semantic RAG.

## Primary Interface

Use the Books API for local catalog discovery, metadata, formats, covers,
local file access, and library statistics.

- Base URL: `http://host.docker.internal:6180`
- Swagger UI: `http://host.docker.internal:6180/docs`
- ReDoc: `http://host.docker.internal:6180/redoc`
- OpenAPI JSON: `http://host.docker.internal:6180/openapi.json`
- Python API client: `scripts/books_api_client.py`

Do not assume endpoint names or hardcode URLs. The Python API client `books_api_client.py` features a dynamic discovery and scoring engine that auto-resolves logical actions (like searching, detail lookup, downloading, covers, stats, health status, and uploading) to the actual active endpoints defined in the current OpenAPI specification (`/openapi.json`). For custom endpoints not covered by logical commands, use the `find` command to discover details dynamically.

## Directory Reference Map

Treat the skill directory as the sandbox for generated files `skills/calibre-ebboks/tmp`. Keep temporary book files, covers, exported local files, and derived artifacts inside `skills/calibre-ebooks/tmp/` unless a runtime explicitly provides a safer
attachment path.

External paths from the sandbox workspace and internal paths inside the sandbox:

- `skills/calibre-ebooks/` - skill root; contains this `SKILL.md`, helper
scripts, server code, and temporary skill artifacts. Sandbox `/workspace/`
- `skills/calibre-ebooks/scripts/` - command-line clients and small automation
helpers. Do not write exported files here. Sandbox `/workspace/scripts/`
- `skills/calibre-ebooks/tmp/downloads/` - temporary local book/file exports meant
for attachment delivery when the user is authorized to access the local
Calibre library. Delete files here after the runtime confirms the
attachment was sent/read. Sandbox `/workspace/tmp/downloads/`.
- `skills/calibre-ebooks/tmp/calibre-covers/` - temporary cover images meant for
`MEDIA:` attachment delivery. Delete files here after successful delivery. Sandbox `/workspace/tmp/calibre-covers/`
- `skills/calibre-ebooks/tmp/` - general scratch area for this skill. It is safe
to create subdirectories here for short-lived generated artifacts. Sandbox `/workspace/tmp`
- `agents/rapport-bibliotecario/memory/calibre-import-queue/` - manual import
queue for received book attachments. This is inside the OpenClaw workspace but
ou

calibre-openclaw-gateway/README.md

# calibre-openclaw-server

FastAPI server to query a local Calibre library and provide RAG semantic search
with page-level citations.

The server uses:

- Calibre `metadata.db` as the book catalog.
- PostgreSQL with `pgvector` for embeddings.
- Ollama to generate embeddings.
- OpenLibrary API for book metadata enrichment and public domain download links.
- Systemd to keep the API running and run RAG in a scheduled window.

## Requirements

- Python 3.10+
- PostgreSQL with `vector` extension
- Ollama running
- Embedding model configured in `OLLAMA_MODEL`
- Local Calibre library with `metadata.db`

## Configuration

Create a `.env` in this directory or in the parent directory `skills/calibre-ebooks/`.
Use `.env.example` as a base.

Essential variables:

```env
CALIBRE_DB_PATH=/path/to/Library/metadata.db
CALIBRE_LIBRARY_PATH=/path/to/Library

API_KEY=secure-token
ALLOW_UNAUTHENTICATED=false

POSTGRESQL_DB_USER=calibre_openclaw
POSTGRESQL_DB_PASSWD=secure-password
POSTGRESQL_DB_DATABASE=calibre_openclaw
POSTGRESQL_DB_HOST=localhost
POSTGRESQL_DB_PORT=5432

OLLAMA_HOST=http://localhost:11434
OLLAMA_MODEL=nomic-embed-text-v2-moe:latest
ALLOW_REMOTE_OLLAMA=false

VT_API_KEY=your-virustotal-api-key
```

Sensitive options, disabled by default in code:

```env
ALLOW_BOOK_CONTENT_DOWNLOADS=false
ENABLE_NETWORK_BINDINGS_ENDPOINT=false
ENABLE_NETWORK_BINDINGS_MONITOR=false
ALLOW_GET_AUTO_SYNC=false
```

## Run the API

```bash
cd skills/calibre-ebooks/calibre-openclaw-server
./run.sh
```

Main URLs:

- API: `http://127.0.0.1:6180`
- Swagger: `http://127.0.0.1:6180/docs`
- ReDoc: `http://127.0.0.1:6180/redoc`
- Health: `http://127.0.0.1:6180/health`

## Ebook Upload and Virus Scanning

The server supports uploading ebook files with format validation and optional virus scanning using VirusTotal API.

### Upload Endpoint

**POST** `/api/books/upload`

Upload an ebook file with automatic format validation. The file is checked to ensure it's a valid ebook format before being accepted.

**Query Parameters:**

- `check_virus` (boolean, optional): Enable virus scanning using VirusTotal API. Requires `VT_API_KEY` to be configured. Default: `false`

**Supported Formats:**

PDF, EPUB, MOBI, AZW3, KFX, DJVU, LIT, PDB, TXT, RTF, DOCX, ODT, FB2, HTML, CBZ, CBR

**Example:**

```bash
curl -X POST "http://127.0.0.1:6180/api/books/upload?check_virus=true" \
  -H "X-API-Key: $API_KEY" \
  -F "[email protected]"
```

**Response:**

```json
{
  "message": "File uploaded successfully",
  "filename": "ebook.pdf",
  "format": "PDF",
  "size_bytes": 1234567,
  "path": "/path/to/library/uploads/ebook.pdf",
  "virus_scan": {
    "scanned": true,
    "malicious": false,
    "detection_ratio": "0/60",
    "file_hash": "abc123...",
    "summary": "Detection ratio: 0/60"
  }
}
```

### Virus Scanning on File Retrieval

Existing file retrieval endpoints support optional virus scanning when `VT_API_KEY` is configured:

- **GET** `/api/books/{id}/pdf?check_virus=true`
- **GET** `/api/books/{i

README.md

# calibre-ebooks

Skill OpenClaw para consultar e operar uma biblioteca Calibre local por meio de
uma API Books local e scripts auxiliares.

Este projeto trabalha somente com livros que já existem na biblioteca Calibre
configurada. Ele não baixa, procura ou adiciona livros de fontes externas.

## Componentes

- `SKILL.md`: fluxo recomendado para agentes OpenClaw.
- `scripts/books_api_client.py`: cliente Python para consultar a API local.
- `calibre-openclaw-server/`: servidor FastAPI, RAG semântico e serviços systemd.
- `.env`: configuração local usada pelos scripts e pelo servidor.

## API Local

Com o servidor ativo:

- Swagger: `http://127.0.0.1:6180/docs`
- ReDoc: `http://127.0.0.1:6180/redoc`
- OpenAPI: `http://127.0.0.1:6180/openapi.json`

## Uso Rápido

```bash
python3 skills/calibre-ebooks/scripts/books_api_client.py docs
python3 skills/calibre-ebooks/scripts/books_api_client.py paths
python3 skills/calibre-ebooks/scripts/books_api_client.py search "termo" --limit 10
python3 skills/calibre-ebooks/scripts/books_api_client.py book 123
python3 skills/calibre-ebooks/scripts/books_api_client.py request GET /books --query q=python
```

## Configuração

Crie ou atualize `skills/calibre-ebooks/.env` com:

- `BOOKS_API_URL`
- `CALIBRE_DB_PATH`
- `CALIBRE_LIBRARY_PATH`
- `API_KEY`
- `POSTGRESQL_DB_USER`
- `POSTGRESQL_DB_PASSWD`
- `POSTGRESQL_DB_DATABASE`
- `POSTGRESQL_DB_HOST`
- `POSTGRESQL_DB_PORT`

As configurações completas ficam documentadas em `.env.example` e no README do
servidor em `calibre-openclaw-server/`.

Recursos que expõem conteúdo completo, enumeram rede local, fazem auto-sync por
GET, usam Ollama remoto ou executam RAG em segundo plano exigem opt-in explícito
no `.env`.

## RAG

O RAG semântico é executado pelo servidor. Para ativar processamento contínuo
manual:

```bash
cd skills/calibre-ebooks
./calibre-openclaw-server/run-rag.sh
```

Para instalação, serviço systemd e agendamento noturno, consulte:

```text
skills/calibre-ebooks/calibre-openclaw-server/README.md
```

_meta.json

{
  "ownerId": "kn70jyx6z4w29h5qq2hbt9jy6s876yc0",
  "slug": "calibre-ebooks",
  "version": "1.0.12",
  "publishedAt": 1781974096247
}

calibre-openclaw-gateway/scripts/requirements-rag.txt

PyMuPDF
EbookLib
pytesseract
Pillow
pdf2image
markdownify
beautifulsoup4
numpy
sentence-transformers
ollama
chromadb
python-dotenv

Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.