Repolode
Submit
amidabuddha

amidabuddha/console-chat-gpt

A Python terminal chat client for OpenAI-compatible LLMs, Ollama and Telegram, with MCP server support.

Open-source alternative to:ChatGPT

View on GitHub
Stars
158
Forks
22
Open issues
0
Last commit
2 days ago

What is it?

console-chat-gpt is a command-line chat application written in Python. It lets you talk to models from OpenAI, Mistral, Anthropic, xAI, Google AI, any OpenAI SDK compatible provider such as DeepSeek or OpenRouter, and locally hosted Ollama models from a single terminal interface. Models are declared in a config.toml file with their base URL, model name and API key.

Beyond plain chat, the app supports the OpenAI Responses and Assistants APIs, image input with selected models, image generation, Anthropic prompt caching, streaming output, and an AI Managed mode that picks one of several configured models based on the prompt. MCP servers can be loaded from an mcp_config.json file. Conversations can be saved on exit and resumed later, and roles and temperature can be set per session.

The same app can run as a Telegram bot, with per-chat pairing, admin commands and optional room-to-model mapping. The project notes that Windows users should run it through WSL.

Key features

  • 01Chat with OpenAI, Mistral, Anthropic, xAI, Google AI and any OpenAI SDK compatible provider from the terminal.
  • 02Run local models hosted by Ollama.
  • 03Supports the OpenAI Responses and Assistants APIs and image generation.
  • 04Loads MCP servers from a Claude Desktop style config file.
  • 05AI Managed mode automatically selects a model based on the prompt.
  • 06Optional Telegram bot interface with pairing and admin commands.

Use cases

  • Comparing answers from several LLM providers without leaving the terminal.
  • Chatting with local Ollama models while keeping data on your machine.
  • Using MCP tools inside a simple chat session.
  • Running a shared AI assistant bot for a Telegram group.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/amidabuddha/console-chat-gpt.git
  2. 2

    Go inside the folder

    cd console-chat-gpt
  3. 3

    Install the necessary dependencies

    python3 -m pip install -r requirements.txt
  4. 4

    Run the executable and enter your API key when prompted on first run

    python3 main.py

Things to know

  • Officially supports Linux and macOS only; Windows users are advised to use WSL.
  • The README points new users to the successor project tellm, so this project is deprecated for new installs.
  • Requires an API key from an LLM provider, or a locally installed Ollama with models already downloaded.

Topics

#cli#llm#openai#ollama#mcp#telegram-bot#chat#python

FAQ

What is console-chat-gpt?
A Python terminal chat client for OpenAI-compatible LLMs, Ollama and Telegram, with MCP server support. console-chat-gpt is a command-line chat application written in Python. It lets you talk to models from OpenAI, Mistral, Anthropic, xAI, Google AI, any OpenAI SDK compatible provider such as DeepSeek or OpenRouter, and locally hosted Ollama models from a single terminal interface. Models are declared in a config.toml file with their base URL, model name and API key.
Is console-chat-gpt free to use? What license does it have?
console-chat-gpt is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is console-chat-gpt still maintained?
Actively maintained. The last commit to console-chat-gpt was on Oct 20, 2026.
What can I use console-chat-gpt for?
Comparing answers from several LLM providers without leaving the terminal. Chatting with local Ollama models while keeping data on your machine. Using MCP tools inside a simple chat session. Running a shared AI assistant bot for a Telegram group.
How do I install console-chat-gpt?
Clone the repository: git clone https://github.com/amidabuddha/console-chat-gpt.git Go inside the folder: cd console-chat-gpt Install the necessary dependencies: python3 -m pip install -r requirements.txt Run the executable and enter your API key when prompted on first run: python3 main.py
Where can I get console-chat-gpt?
The source code and installation instructions are on GitHub: https://github.com/amidabuddha/console-chat-gpt

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects