============
HoneyDB AI
============

**v0.2.2** — A command-line interface that connects your LLM to HoneyDB's threat intelligence tools via the `Model Context Protocol (MCP) <https://spec.modelcontextprotocol.io/>`_.

Features
--------

- Natural language chat interface to HoneyDB threat intelligence data
- MCP tool integration — LLMs invoke HoneyDB tools automatically during conversation
- Supports OpenAI, Anthropic, and Google Gemini providers
- Animated thinking indicator with bee/honeypot-themed feedback
- Session management — save, resume, and export chat sessions
- Rich terminal output with markdown rendering and syntax highlighting
- Graceful Ctrl+C cancellation without data loss

Requirements
------------

- Python 3.10 or newer
- HoneyDB API credentials (`sign up at honeydb.io <https://honeydb.io/>`_)
- At least one LLM provider API key (OpenAI, Anthropic, or Gemini)

Installation
------------

.. code-block:: bash

    pip install honeydb-ai

Quick Start
-----------

Run the interactive setup wizard:

.. code-block:: bash

    honeydb-ai config setup

Then start chatting:

.. code-block:: bash

    honeydb-ai chat

See all available commands:

.. code-block:: bash

    honeydb-ai --help

Links
-----

- `HoneyDB Platform <https://honeydb.io/>`_

License
-------

Proprietary — Copyright (c) Deception Logic. See LICENSE for details.
