OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Workflow Agents

Talk To Girlfriend AI

Talk To Girlfriend AI is an open-source Telegram conversational agent that uses Claude Sonnet to suggest or improve messages and Nia semantic search to find pickup lines, dating guides and conversation tips. A TypeScript command-line agent connects to Telegram through a Python API bridge and MCP integration.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Talk To Girlfriend AI — OpenViST project profile in Workflow Agents.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it for a locally configured Telegram workflow that combines message drafting or enhancement with retrieval from dating and conversation content, or for the separately described Telegram MCP tools.

Who it is for

  • Telegram users who want AI suggestions based on their conversation context.
  • Developers setting up a Telegram agent that combines LLM reply generation with semantic search.
  • Users of Claude Desktop or Cursor seeking a separate Telegram MCP server.

Documented uses

  • Get a reply suggestion informed by messages in a Telegram conversation.
  • Rewrite a draft to make it wittier or more engaging.
  • Search curated pickup lines, dating guides and conversation tips.
  • Read, send, search, edit, delete, forward or react to Telegram messages through natural-language requests.
Before you choose

Requirements & limits

The project is a public repository under the Apache-2.0 license. Its documented agent setup requires Telegram API credentials, an AI Gateway API key and Nia credentials.

  • The reply agent and standalone MCP server are separate usage paths; the README describes the MCP server as usable without the AI agent.
  • The agent requires both Telegram access credentials and credentials for its AI and retrieval services.
  • The documented stack includes a TypeScript CLI agent and Python Telegram bridge, with Claude Sonnet and Nia as service components.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Set up the Telegram agent

Prepare the repository, credentials and services needed to start the Telegram bridge and agent.

Before you start

  • Telegram API ID and API hash
  • AI Gateway API key
  • Nia API key and Nia source UUID
  • Python dependencies installed with uv
  • Bun for the TypeScript agent

Steps

  1. Clone the repository and install Python dependencies with the command below.

    Documented command
    uv sync

  2. Generate a Telegram session string using the command below.

    Documented command
    uv run session_string_generator.py

  3. Copy .env.example to .env and enter the Telegram and AI service credentials.

  4. Start the bridge with the command below.

    Documented command
    python telegram_api.py

  5. In the agent directory, install dependencies with bun install and start the agent with bun run dev.

Expected outcome

The README describes a running Telegram API bridge and conversational agent for natural-language chat tasks.

Guide limitations

  • The guide requires credentials from Telegram, the AI gateway and Nia.
  • The repository documents setup steps but this guide does not claim they were executed or verified.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
15 October 2026
Original website title
arlanrakh/talk-to-girlfriend-ai · Official homepage title · retained in its source language
How we review sourcesSuggest a correction