Issue Station
Sign In
Tools hereToolbox

llamaIndex - 💡(How to fix) Fix [Feature Request]: List llama-index-tools-osint on LlamaHub

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Code Example

pip install llama-index-tools-osint

---

from llama_index.tools.osint import OSINTToolSpec
from llama_index.agent.openai import OpenAIAgent
from llama_index.llms.openai import OpenAI

osint = OSINTToolSpec(api_key="osint_your_key")
agent = OpenAIAgent.from_tools(
    tools=osint.to_tool_list(),
    llm=OpenAI(model="gpt-4o"),
)
agent.chat("What's happening in cybersecurity today?")
RAW_BUFFERClick to expand / collapse

Feature Description

I've built and published llama-index-tools-osint — an OSINT intelligence platform tool for LlamaIndex that provides real-time intelligence reports, domain reconnaissance, and social media lookup.

PyPI: https://pypi.org/project/llama-index-tools-osint/ GitHub: https://github.com/ahsan3274/llama-index-tools-osint

What it does

  • get_enriched_reports(category?) — LLM-analyzed intelligence briefings across 15 categories (cybersecurity, geopolitics, finance, tech_ai, etc.) from 129+ RSS feeds
  • get_categories() — List available categories with confidence scores and article counts
  • domain_recon(domain) — DNS records, WHOIS data, and IP intelligence
  • social_lookup(username) — Profile lookup across 10 platforms (GitHub, Twitter, Instagram, Reddit, YouTube, Medium, GitLab, Keybase, SoundCloud, Twitch)

Why it's valuable

OSINT (Open Source Intelligence) is a critical capability for AI agents researching real-world entities, monitoring threat landscapes, and gathering contextual data. This tool bridges the gap between raw web search and structured intelligence briefings, giving LLM agents access to curated, LLM-enriched reports updated daily.

Installation

pip install llama-index-tools-osint

Usage

from llama_index.tools.osint import OSINTToolSpec
from llama_index.agent.openai import OpenAIAgent
from llama_index.llms.openai import OpenAI

osint = OSINTToolSpec(api_key="osint_your_key")
agent = OpenAIAgent.from_tools(
    tools=osint.to_tool_list(),
    llm=OpenAI(model="gpt-4o"),
)
agent.chat("What's happening in cybersecurity today?")

Package Details

  • Version: 0.1.0
  • Tests: 12 passing with mocked API calls
  • LlamaHub metadata: Included in pyproject.toml ([tool.llamahub])
  • License: MIT
  • Python: 3.10+

Reason

LlamaIndex no longer accepts new integrations in the monorepo, so this was published as an independent PyPI package following the updated contribution guidelines. I'd like to request it be listed on LlamaHub.ai alongside other third-party integrations.

Value of Feature

OSINT capabilities are increasingly important for AI agents. This tool provides structured, multi-source intelligence gathering that complements existing tools like Wolfram Alpha, Tavily, and DuckDuckGo — giving agents access to LLM-enriched geopolitical, cybersecurity, and market intelligence briefings.

extent analysis

TL;DR

To integrate the llama-index-tools-osint package with LlamaIndex, ensure you follow the updated contribution guidelines and properly configure the OSINT tool with a valid API key.

Guidance

  • Verify that the llama-index-tools-osint package is correctly installed using pip install llama-index-tools-osint.
  • Confirm that the API key used in the OSINTToolSpec initialization is valid and properly configured.
  • Review the updated contribution guidelines to ensure compliance with LlamaIndex's integration requirements.
  • Test the integration using the provided example code and verify that the OSINT tool is functioning as expected.

Example

osint = OSINTToolSpec(api_key="your_valid_osint_api_key")

Replace "your_valid_osint_api_key" with your actual OSINT API key.

Notes

The provided code snippet assumes that the OSINTToolSpec class and OpenAIAgent class are correctly implemented and imported. Ensure that the llama-index-tools-osint package is compatible with your LlamaIndex version.

Recommendation

Apply the workaround by verifying the API key and configuration, as the issue seems to be related to the integration process rather than a version-specific problem.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#installation#database connection#vector store#embedding generation

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING