3,146
edits
Changes
From Gramps
no edit summary
;Features
*ChatWithTree shows Shows a chat like interface
*Select Large Language Model (LLM) models from several different AI providers
**Apart from the free local models using self-started tools (ollama), you can also connect to hosted sites for openai, anthrophic, openrouter etc, all thanks to the llm python model
**You have to create an API key for the model that you want to use
*Start anywhere in your tree using the “search by name” tool
*Person information looks into searches the person notes of Gramps to tell about the people found
*When the AI bot is thinking, it shows the thinking in the chat - showing the strategy to answer difficult questions
== Usage ==
[[#Installation|Add and install]] the external '''ChatWithTree ''' project along with the required [[#Prerequisites|''litellm '' Python module prerequisite]] and then [[#Add_ChatWithTree_to_the_Gramps_Dashboard|add]] the ChatWithTree {{man label|Chat With Tree}} Gramplet to the Dashboardview.
In the ChatWithTree {{man label|Chat With Tree}} Gramplets empty textbox entry field at the bottom of the screen you can:
* Start a chat by typing a text message and pressing the {{man button|Send}} button or
=== Commands ===
These commands control the settings of the ChatWithTree {{man label|Chat With Tree}} Gramplet addon:
* /help - shows a generic help text
==== /history command ====
Thie /history command shows the full chat-history of what ChatWithTree {{man label|Chat With Tree}} Gramplet has gathered in memory. This is a very verbose version of the chat, with a some internal ways of showing information like Javascript Object notation (JSON) - mostly interesting if you want to know in detail what conversation the addon has been doing with the LLM
==== /setmodel command ====
With the /setmodel command you select the model the ChatWithTree {{man label|Chat With Tree}} Gramplet addon opens up the conversation. Some examples are:
* /setmodel ollama/deepseek-r1:1.5b
== How does it all work? ==
The ChatWithTree {{man label|Chat With Tree}} Gramplet is built in such a way that it sends off a list of "tool names" to the LLM, and based on the message sent, will determine what tools it needs to respond. The tools in the respond execute an interaction with your Gramps database, and the results are then send back to the LLM again, so that the LLM can process the information for an answer.
This interaction between tool calling, thinking of the model, is shown in the ```yellow balloons```.
== Privacy warning ==
<span style="color: red;">Privacy warning</span>. The ChatWithTree {{man label|Chat With Tree}} Gramplet addon uses tools to query your Gramps database, and sends off the found information to the LLM's. When you use remote LLMs that are running in the cloud, for example via OpenRouter, be aware that your local data is send to those models! If privacy is of your concern, then always ensure to run this tool only with local running models, for example using a local setup with tools that enable running LLMs locally. One example of that is with https://www.ollama.com/
== Installation ==
The ChatWithTree addon is a Dashboard addon. This means that the addon displays on the default Grampls Dashboard.
After installing the addon via the addon-managerAddon Manager, go to the Dashboard and {{man menu|Add a gramplet > Chat With Tree Interactive Addon}}. by right clicking and installing in the dashboard.
[[File:chatwithtree-addtodashboard.png]]
