Practical overview
When it fits
Use it when a Java application needs a configurable research pipeline that combines an LLM with a citation source.
Who it is for
- Java developers adding research workflows to applications.
- Teams building domain-specific research assistants that need query analysis and citation fetching.
Documented uses
- Analyze a research query and produce an answer with citations.
- Keep context across related research queries in a session.
- Personalize responses using a profile's expertise level and preferences.
- Configure reasoning methods and output as Markdown, JSON or tables.
Requirements & limits
The repository is public and identifies the project as MIT-licensed. The documented prerequisite is Java 21 or later, plus API keys for at least one LLM provider and one citation source.
- The library requires both an LLM provider and a citation source to be configured.
- Documented LLM options include OpenAI and Google Gemini; citation options include Google Search and Tavily.
- Google Search setup requires a Programmable Search Engine ID and API key.
- The README describes virtual-thread-based execution and requires Java 21 or later.
- The documented integration formats are Markdown, JSON and tables.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Configure Google Search credentials for Research4J
Prepare the Google Programmable Search Engine credentials that Research4J uses to fetch citations.
Before you start
- A Google Programmable Search Engine
- A Programmable Search Engine API key
Steps
Create a Custom Search Engine through Google Programmable Search Engine.
Copy the CSE ID from its dashboard and configure it as GOOGLE_CSE_ID.
Generate a Programmable Search Engine API key and configure it as GOOGLE_SEARCH_API_KEY.
Expected outcome
The Google Search citation-source credentials are configured for Research4J.
Guide limitations
- Research4J also requires credentials for at least one LLM provider.
- This guide covers Google Search setup, not a complete application build or execution.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- bhavuklabs/research4j · Official homepage title · retained in its source language

