LLM-based Chat Assistant

From OSGeo
Jump to navigation Jump to search

LLM-based Chat Assistant

Experimental LLM-based chat assistant bot available in the OSGeo Matrix space.

The bot connects Matrix chat to an LLM agent and local MCP tools for OSGeo-specific search, wiki lookup, document search, and web/time/weather utilities.

Access

The bot is available in the Matrix room:

#lounge:osgeo.org
#library:osgeo.org

Matrix identifier:

@llm-assitant:matrix.org

The bot responds when mentioned, or when a line starts with:

!oc
bot

Example:

!oc search the OSGeo wiki for board elections
bot what is GeoNode?
@llm-assitant:matrix.org find OSGeo documents about map projections

Usage notes

The assistant is experimental. It may make mistakes, especially for operational or infrastructure-critical questions. Verify important answers before acting on them.

Do not send secrets, passwords, API keys, private tokens, or sensitive credentials to the bot.

Tool calls may be visible in chat logs. This is normal. Example:

> query=spam, limit=10 [osgeo-knowledge_search_content]
> query=spam, limit=10 [osgeo-knowledge_search_wiki]

The prefix identifies the MCP server, and the suffix identifies the tool.

OSGeo Knowledge tools

These tools query Osgeo-knowledge-base.

  • osgeo-knowledge_search_wiki - Search AI-generated summaries and keywords
  • osgeo-knowledge_search_content - Search raw page content chunks
  • osgeo-knowledge_search_entities - Search people, projects, organizations, events
  • osgeo-knowledge_get_entity_relationships - Query entity relationships
  • osgeo-knowledge_get_page - Retrieve full page content
  • osgeo-knowledge_get_wiki_stats - Show database and sync statistics

OSGeo Library tools

These tools query osgeo-library through the doclibrary MCP server.

  • doclibrary_search_documents - Semantic search over document text and visual elements
  • doclibrary_search_visual_elements - Search figures, tables, equations, charts, and diagrams
  • doclibrary_list_elements - Browse document elements without semantic search
  • doclibrary_get_element_details - Retrieve metadata for a visual element
  • doclibrary_get_element_image - Retrieve a cropped element image
  • doclibrary_get_page_image - Retrieve a full page image
  • doclibrary_get_document_info - Show document metadata
  • doclibrary_find_document - Find a document by name or query
  • doclibrary_list_documents - List indexed documents
  • doclibrary_get_library_status - Check document library service status

Technical details

Language model: opencode/big-pickle, may change. Ask the bot for current model information.

Operations

Check the bridge process on Gallery:

pgrep -af "bun connectors/matrix.ts"

Check active MCP processes:

pgrep -af "mcp|osgeo-knowledge|osgeo-library"

Administration

TBD

Contact: ominiverdi, Lorenzo Becchi, or SAC channel.