GENE-Gutendex
GENE-Gutendex integrates the Gutendex API into your Feluda application, providing your AI assistant and Feluda Flows with instant access to metadata from the Project Gutenberg catalog.
GENE-Gutendex: Project Gutenberg Book Metadata at Your Fingertips
GENE-Gutendex integrates the Gutendex API into your Feluda application, providing your AI assistant and Feluda Flows with instant access to metadata from the Project Gutenberg catalog. With this gene installed, your AI can perform keyword searches across hundreds of thousands of public-domain book records, fetch detailed information about any specific Gutenberg work by its ID, and automatically store and index every request for later review. Data returned includes titles, authors, summaries, subjects, download links in all available formats, language information and more – all presented as clean JSON that your models can consume directly.
Whether you are building literature‑centric chatbots, automating catalog enrichment, powering educational tools, or simply need reliable book metadata for reasoning, GENE-Gutendex gives you free, programmatic access to Gutenberg's collection with no credentials and no rate limits. The gene handles paging, raw-response storage, and history logging so you can focus on building intelligent flows.
What can I do with GENE-Gutendex enabled?
Once the gene is connected, your AI can:
- Perform full-text searches using arbitrary query terms, optionally filtering by language, page number, and page size.
- Retrieve full metadata for a single Gutenberg book by its numeric ID.
- Store every raw JSON response in the dataspace for offline inspection and auditing.
- Log all requests in a lightweight SQLite database with timestamps, endpoint, query and filename for quick lookups.
- Page through large responses using built‑in chunking support.
These capabilities make it easy to build workflows such as recommending books by keyword, converting catalog IDs to full records, comparing metadata across editions, or simply exploring the Gutenberg collection interactively.
What tools does GENE-Gutendex include?
GENE-Gutendex exposes two simple search tools. Each tool supports a help call that returns a plain-language summary of what it does, the parameters it accepts (including which are required), and example usage. Your AI can always ask a tool to explain itself before making a call, ensuring reliable operation even with models that have never seen the gene before.
| Tool | What it does |
|---|---|
| gutendex search | Performs a keyword search against the Gutendex catalog. You can specify arbitrary query terms and optionally filter by language, page number, and page size. Returns a page of matching book metadata including title, authors, subjects, languages, formats, and a numeric Gutenberg ID. Results are logged and the raw JSON is saved if enabled. |
| gutendex book | Retrieves full metadata for a single Gutenberg work given its numeric ID. This returns all available fields for the book, including download links for every format Gutendex provides. |
What is the data source behind GENE-Gutendex?
GENE-Gutendex talks directly to the public Gutendex API, an open service that mirrors Project Gutenberg's catalog. The API requires no authentication, has no rate limits, and provides up-to-date metadata for hundreds of thousands of public-domain books. GENE-Gutendex simply fetches that metadata and returns it to your AI as structured JSON.
No account or credentials required
The gene works immediately after installation. There is no API key, no account sign‑up, and no credentials to manage. All requests are read-only and go directly to the free Gutendex service.
Settings you can configure
The gene exposes several settings from the Feluda Settings page that let you tune its behavior:
| Setting | Description |
|---|---|
| User Agent | The identifier sent with every HTTP request. The default identifies requests as coming from Feluda; change it only if you need a custom string. |
| API Base URL | The Gutendex endpoint used for all requests. The default is https://gutendex.com. Change this if you are using a self-hosted mirror. |
| Default Page Size | The number of results returned by the search tool when no page size is specified. Defaults to 32; adjust for larger or smaller responses. |
| Max Tokens In Response | Controls the maximum size of a single tool response before the gene splits it into pages. Set this to match your model's context window. |
| Store Raw Responses | When enabled, every raw JSON payload received from Gutendex is saved under the gene's dataspace. Useful for debugging and auditing; disable to keep the dataspace clean. |
| History Retention Days | Determines how many days of lookup history are kept in the local SQLite database. Older records are pruned when history is cleaned. |
Every tool has built-in help
Each tool supports a help case. Calling a tool with help returns a structured description of its behavior, parameters, and examples. This allows your AI to discover the gene's capabilities dynamically and reduces the chance of malformed tool calls.
How GENE-Gutendex works inside Feluda Flows
When used within Feluda Flows, the Gutendex tools can be combined into automated pipelines:
Real-world use cases
These examples show how users benefit from GENE-Gutendex:
Handy starting commands
Prompt your AI with these examples once GENE-Gutendex is installed. Feel free to adapt the wording:
| What you want to do | What to say to your AI | What happens |
|---|---|---|
| Search for books | Search Gutenberg for “Pride and Prejudice” and show me the first page of results. | Performs a keyword search and returns a list of matching works with titles, authors, and IDs. |
| Lookup by ID | Get metadata for Gutenberg book 1342. | Retrieves the full record for the book with ID 1342. |
| Filter by language | Find French books about science. | Runs a search with language=fr and query=science, returning matching French works. |
| Large page size | Show me 100 results for “Shakespeare”. | Searches with page_size=100 and returns a larger list of matches. |
| Inspect raw response | Use the developer tool to read the latest raw file. | The gutendexDev tool returns metadata about stored raw responses and can read them in chunks. |
Free, open metadata from Project Gutenberg
Project Gutenberg's catalog of public-domain books is one of the largest free literary collections on the web. GENE-Gutendex provides instant, programmatic access to that catalog through the open Gutendex API. There are no fees, no quotas, and no authentication hoops; the data flows directly into your Feluda application so your AI can reason about books and authors as easily as any other topic.
You might also like
Activate GENE-GUTENDEX
Current credits: 0
After activation: 0