AI

From Tučňák Wiki
Jump to navigation Jump to search

AI assistant

Experimental. Available since Tucnak 5.03. The AI assistant is a window in Tucnak. You can ask it questions about your contest. It reads the KST chat, your log and your score. It tells you which station is good to work next. It is made mainly for VHF contests, together with the KST window.

The assistant only gives advice. It never writes to the KST chat and never writes to the log. You send all messages yourself.

What it can do

  • Make a list of the best stations on the active band. The best station is the one that gives the biggest growth of your total score. Tucnak counts the score by the rules of your contest. New multipliers are most important.
  • Skip stations you already worked on the band (dupes). Skip also stations farther than the maximum QRB set in the KST options.
  • Tell you what a QSO with a station is worth: points, new multipliers and growth of the total score. You see this before you make the QSO.
  • Summarize the KST chat and tell you what is important.
  • Answer questions about the contest: your log, the score on each band, the multipliers, the distance and azimuth between two locators, and whether you already worked a station on a band.
  • Watch the KST chat by itself. New chat lines go to the model every 30 seconds. The assistant writes only when it has something useful. Each batch uses tokens, so it costs a little money.
  • Turn the antenna to an azimuth (for example turn to 270) and set the frequency and mode of the radio (for example tune to 144.300 SSB). It does this only when you ask. It never transmits.

How to use it

  1. Open Setup / AI assistant. Tick Enable. Choose the provider (see below), type the API key and check the model.
  2. Open the AI window. It is a subwin like the others and its title is AI. Type a question and press Enter. The assistant starts with your first question.
  3. Click the right mouse button on the window. The menu has ready questions (best stations, summary of the chat), Start AI, Stop AI, Clear window and Show KST window.
  4. Click on a callsign in the window. You get the same menu as in the KST window (sked, message, info and so on).
  5. When you stop the assistant, it shows how many messages and tokens you used.

The assistant does not guess. It asks Tucnak for the data it needs. These requests only read data: the state of Tucnak, the KST chat and the list of stations, the log, the score, and the value of a QSO. Only two things can change: the rotator and the radio. They change only when you ask.

Providers

Tucnak uses the OpenAI compatible API (<URL>/chat/completions). The button Choose fills in the URL and a model. You only type the API key. You can also use another server with the same API. Then type the URL and the model yourself.

Provider API URL Suggested model Note
DeepSeek https://api.deepseek.com deepseek-chat tested
Google Gemini https://generativelanguage.googleapis.com/v1beta/openai gemini-3.5-flash-lite tested
OpenAI https://api.openai.com/v1 gpt-4o-mini untested
Anthropic https://api.anthropic.com/v1 claude-haiku-4-5-20251001 untested
Mistral https://api.mistral.ai/v1 mistral-small-latest untested
Groq https://api.groq.com/openai/v1 llama-3.3-70b-versatile untested
OpenRouter https://openrouter.ai/api/v1 deepseek/deepseek-chat untested
Ollama (local) http://127.0.0.1:11434/v1 qwen2.5:7b untested, no API key needed
LM Studio (local) http://127.0.0.1:1234/v1 (choose the model in the server) untested, no API key needed

The model must support tool calls (function calling). Small local models are often weak at this, and they are slow on a CPU. I do not recommend them. Model names change often, so check the list of models at your provider. Models that need their own "thinking" sent back are not supported (for example deepseek-reasoner).

Please note

  • You need an account and an API key from the provider. You usually pay for each token. With a cheap model one contest costs little, but check the prices.
  • The model gets data from Tucnak: your callsign and locator, your log and score, and the KST chat. This data goes to the server of the provider. With a local server it stays on your computer. If you do not want this, do not enable the assistant.
  • The API key is saved in the file tucnakrc as plain text. Do not publish this file.
  • The KST chat is written by other people. The assistant treats it as data and not as orders.
  • The assistant can be wrong. Check its advice before you call a station.