An LLM-based assistant for the Automatic Packet Reporting System (APRS).

[!IMPORTANT] This library provides core functionality for an LLM-based APRS chatbot, but does not itself directly handle APRS messaging (RX, or TX). If you want to run APRS Assistant yourself, on the APRS IS network, you should visit the sister project aprs-assistant-plugin, which has everything you need.

For local development, or to integrate APRS Assistant into other frameworks, read on. For running APRS Assistant, heed the above advice and go to aprs-assistant-plugin now.

pip install aprs-assistant

Your bot needs a callsign! Set with the APRS_ASSISTANT_CALLSIGN environment variable.

export APRS_ASSISTANT_CALLSIGN=<CLEVER_CALLSIGN>

At a minimum, this library requires setting an OpenAI API key. Bing and APRS.fi API keys are also used to support various tools and services. Set the, as environment variable in bash, as follows:

export OPENAI_API_KEY=<YOUR_KEY>
export BING_API_KEY=<YOUR_KEY>
export APRSFI_API_KEY=<YOUR_KEY>

The library supports local chats (e.g., for debugging) as follows:

python -m aprs_assistant <YOUR_CALLSIGN>

Type exit or press Ctrl-D to exit.

APRS Assistant supports basic callsign lookups using a local copy of the FCC ULS database. This database is about 325 MB and is easily created.

cd ./tools/parse_fcc_uls
bash create_db.bash
cd ../..
mkdir data
mv ./tools/parse_fcc_uls/fcc_uls.db data/.

This step only needs to be done once (or when you wish to update the database with new records!)

See ./tools/parse_fcc_uls/README for more details.

To integrate aprs-assistant into your application, simply use:

from aprs_assistant import generate_reply

sender_callsign = "NOCALL"
message = "What's the weather?"
response = generate_reply(sender_callsign, message)

print(response)

Note: response can be None

• APRS location data provided by aprs.fi
• Weather data provided by open-meteo
• Weather watches, warnings and alerts provided by weather.gov
• Reverse geocoding provided by Nominatim
• Band conditions and space weather provided by hamsql.com
• FCC call sign information provided by FCC public access program
• Web search and news results provided by the Bing Search API

aprs-assistant is distributed under the terms of the MIT license.