Download

Download from GitHub: TermTalk 0.1-alpha (Release info)

Overview

TermTalk is a command-line application that enables direct communication with AI models (like GPT-4) from your terminal. It offers both interactive conversations and quick Q&A sessions, with the added ability to analyze file contents, making it a versatile tool for users needing fast, terminal-based AI interactions. All conversation data is stored locally in a secure SQLite database, ensuring both privacy and accessibility.

Available on GitHub: github.com/termtalk/termtalk.

Key Features

  • Convenient Access: Engage with AI anytime directly from your Linux console.

  • Local Data Storage: Conversations are stored in a simple, local SQLite database, allowing easy access while ensuring data privacy. You have full control over all conversation content.

  • Flexible Pricing: Unlike ChatGPT’s fixed $20/month fee, OpenAI API usage is billed based on actual consumption, meaning you only pay for what you use.

  • Enhanced Privacy: While ChatGPT retains conversations for model training, using the OpenAI API directly ensures that your conversations remain private.

  • Controlled Access: Easily provide access to others (e.g., family or team members) by managing their usage with individual API keys, offering more control over expenses.

Installation

To get started with TermTalk, follow these steps:

  • Download the Code: Clone or download the latest version from GitHub:
    github.com/termtalk/termtalk.

  • Unpack: Extract the code to your desired location (e.g., ~/termtalk).

  • First Run Setup: Launch the application for the first time:

    • ./tt

This will automatically create a virtual environment (venv), install dependencies, and generate a default configuration file. You will also be prompted to enter your OpenAI API Key during setup.

Quick Start

Once installed, TermTalk is easy to use from the command line. Here are some usage examples:

  • Interactive Mode: Start an interactive AI session:

    ./tt

    Type exit to quit or ? for help. Commands start with /, while regular messages are sent to the AI model.

  • Question-Answer Mode: Send a single question and get a response:

    ./tt "How to make ice cream?"

  • File Attachment: Attach a file for AI analysis (e.g., to diagnose logs):

    ./tt -f diagnostics.log "Analyze the log file and explain the problem"

  • Command Options: Use ./tt -h to view all available parameters, such as -v for verbose mode or -np to suppress prompts.

OpenAI API Key Setup

  1. Create an API Key: Go to OpenAI API Keys and select + Create new secret key. Ensure your API key has the necessary permissions:
    READ
    /v1/models

    WRITE
    /v1/audio
    /v1/chat/completions
    /v1/embeddings
    /v1/images
    /v1/moderations
  2. Manage Usage: Pre-pay a balance on your account (e.g., $10) and set usage limits to avoid unexpected charges. Suggested settings:
    • Monthly Budget: $10
    • Alert Threshold: $8
  3. Privacy Note: Keep your API key private, as it grants access to your OpenAI account.

Documentation

Detailed documentation, including command references and configuration options, is available at termtalk.github.io.

Connect with Us

Stay updated and connect with the TermTalk community on LinkedIn: TermTalk on LinkedIn.

Warranty

TermTalk is provided AS-IS without warranty. While efforts have been made to ensure reliability, the author does not guarantee it is error-free or suitable for all use cases. The application does not collect personal data; all interactions remain on your local device.

Liability: The author assumes no responsibility for any damages resulting from the use of TermTalk. Use at your own risk.

Download

Download from GitHub: TermTalk 0.1-alpha (Release info)