Chore: readme update

This commit is contained in:
Grail Finder
2025-06-17 07:18:45 +03:00
parent 9eb2fac0b3
commit 2040473468
2 changed files with 41 additions and 4 deletions

View File

@@ -1,22 +1,59 @@
### gf-lt (grail finder's llm tui) ### gf-lt (grail finder's llm tui)
Terminal program to chat with llm. Terminal user interface for large language models.
#### Has/Supports #### has/supports
- character card spec; - character card spec;
- llama.cpp api, deepseek (other ones were not tested); - llama.cpp api, deepseek (other ones were not tested);
- showing images (not really, for now only if your char card is png it could show it); - showing images (not really, for now only if your char card is png it could show it);
- tts/sst (if whisper.cpp server / fastapi tts server are provided); - tts/stt (if whisper.cpp server / fastapi tts server are provided);
#### does not have/supprot
- images; (ctrl+j will show an image of the card you use, but that is about it);
- RAG; (RAG was implemented, but I found it unusable and then sql extention broke, so no RAG);
- MCP; (agentic is implemented, but as a raw and predifined functions for llm to use. see [tools.go](https://github.com/GrailFinder/gf-lt/blob/master/tools.go));
#### usage examples #### usage examples
![usage example](assets/ex01.png) ![usage example](assets/ex01.png)
#### how to install #### how to install
(requires golang)
clone the project clone the project
``` ```
cd gf-lt cd gf-lt
make make
``` ```
#### keybindings
while running you can press f12 for list of keys;
```
Esc: send msg
PgUp/Down: switch focus between input and chat widgets
F1: manage chats
F2: regen last
F3: delete last msg
F4: edit msg
F5: toggle system
F6: interrupt bot resp
F7: copy last msg to clipboard (linux xclip)
F8: copy n msg to clipboard (linux xclip)
F9: table to copy from; with all code blocks
F11: import chat file
F12: show this help page
Ctrl+w: resume generation on the last msg
Ctrl+s: load new char/agent
Ctrl+e: export chat to json file
Ctrl+n: start a new chat
Ctrl+c: close programm
Ctrl+p: props edit form (min-p, dry, etc.)
Ctrl+v: switch between /completion and /chat api (if provided in config)
Ctrl+r: start/stop recording from your microphone (needs stt server)
Ctrl+t: remove thinking (<think>) and tool messages from context (delete from chat)
Ctrl+l: update connected model name (llamacpp)
Ctrl+k: switch tool use (recommend tool use to llm after user msg)
Ctrl+j: if chat agent is char.png will show the image; then any key to return
Ctrl+a: interrupt tts (needs tts server)
```
#### setting up config #### setting up config
``` ```
cp config.example.toml config.toml cp config.example.toml config.toml

2
tui.go
View File

@@ -38,7 +38,7 @@ var (
indexPage = "indexPage" indexPage = "indexPage"
helpPage = "helpPage" helpPage = "helpPage"
renamePage = "renamePage" renamePage = "renamePage"
RAGPage = "RAGPage " RAGPage = "RAGPage"
propsPage = "propsPage" propsPage = "propsPage"
codeBlockPage = "codeBlockPage" codeBlockPage = "codeBlockPage"
imgPage = "imgPage" imgPage = "imgPage"