使用说明
Telegram AI约会代理
附言：之后我们分手了
一个由人工智能驱动的Telegram代理，可帮助您为对话制作诙谐、引人入胜的消息。由克劳德·索内特建造， 妮娅 语义搜索和功能齐全的Telegram MCP集成。
它的作用
- 智能回复建议：根据对话上下文获取人工智能支持的响应建议
- 500多条取件线：通过Nia索引的精选搭讪台词进行语义搜索
- 约会指南：搜索有关如何与女性交谈、搭讪技巧和调情技巧的指南
- 消息增强：将无聊的信息转化为诙谐、引人入胜的信息
- 完全电报访问：通过自然语言阅读消息、发送回复、管理聊天记录
由Nia提供技术支持
此代理使用 妮娅 作为其知识检索引擎。Nia索引和搜索：
- 500多条精心策划的搭讪台词（有趣、俗气、聪明、浪漫）
- 对话技巧指南
- 保持对话引人入胜的技巧
您可以通过在以下位置创建源来索引自己的内容 trynia.ai.
建筑
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ CLI Agent │────▶│ Telegram API │────▶│ Telegram │
│ (TypeScript) │ │ Bridge (Py) │ │ Servers │
└──────────────────┘ └──────────────────┘ └──────────────────┘
│
▼
┌──────────────────┐ ┌──────────────────┐
│ Claude Sonnet │ │ Nia API │
│ (AI Gateway) │ │ (trynia.ai) │
└──────────────────┘ └──────────────────┘
- 500+ pickup lines
- Dating guides
- Conversation tips
快速开始
1.获取Telegram API证书
在获取API证书 my.telegram.org/apps.
2.安装和配置
# Clone the repo
git clone https://github.com/arlanrakh/talk-to-girlfriend-ai.git
cd talk-to-girlfriend-ai
# Install Python dependencies
uv sync
# Generate Telegram session string
uv run session_string_generator.py
# Configure environment
cp .env.example .env
# Edit .env with your credentials
3.启动Telegram API桥接
python telegram_api.py
这在端口8765上运行一个FastAPI服务器，将TypeScript代理连接到Telegram。
4.运行AI代理
cd agent
bun install
bun run dev
用法示例
运行后，与自然语言交互：
# Reading & Sending
> Show me messages from @her_username
> Send "Hey, I was just thinking about you" to @her_username
> Reply to her last message with something witty
# Reactions
> React to her last message with ❤️
> Send a 🔥 reaction to message 123
# Search & History
> Search our chat for "dinner plans"
> Show me the last 50 messages with her
> Find me a funny pickup line about pizza
# AI Assistance
> What should I reply to her message about coffee?
> Make this message more flirty: "want to hang out tomorrow?"
> Search for tips on how to keep a conversation going
# User Info
> Is she online right now?
> Check her status
# Message Management
> Edit my last message to fix the typo
> Delete message 456
> Forward that meme to @friend
代理命令
/help-显示帮助/clear-清除对话历史记录/status-检查连接状态/quit-退出
环境变量
创建 .env 项目根目录中的文件：
# Telegram API (Required)
TELEGRAM_API_ID=your_api_id
TELEGRAM_API_HASH=your_api_hash
TELEGRAM_SESSION_STRING=your_session_string
# AI Services (Required for agent)
AI_GATEWAY_API_KEY=your_vercel_ai_gateway_key
NIA_API_KEY=your_nia_api_key
NIA_CODEBASE_SOURCE=your_pickup_lines_source_uuid
替代方案：用作MCP服务器
您还可以将其用作带Claude Desktop或Cursor的独立MCP服务器，而无需AI代理。
添加到MCP配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"telegram": {
"command": "uv",
"args": ["--directory", "/path/to/telegram-mcp", "run", "main.py"]
}
}
}
这暴露了60多种Telegram工具，包括消息传递、联系人、群组、渠道、反应等。
可用工具
代理工具（20+）
核心信息
| 工具 | 说明 |
|---|---|
getChats |
列出所有对话 |
getMessages |
阅读聊天中的消息 |
sendMessage |
发送消息 |
getChat |
获取聊天详细信息 |
searchContacts |
搜索联系人 |
反应和回复
| 工具 | 说明 |
|---|---|
sendReaction |
反应与❤️ 🔥 😂 等等 |
replyToMessage |
回复特定消息 |
编辑和删除
| 工具 | 说明 |
|---|---|
editMessage |
修复发送后的拼写错误 |
deleteMessage |
删除邮件 |
历史与搜索
| 工具 | 说明 |
|---|---|
getHistory |
最多可接收500条消息 |
searchMessages |
按文本搜索聊天 |
转发和固定
| 工具 | 说明 |
|---|---|
forwardMessage |
转发到另一个聊天 |
pinMessage |
固定重要消息 |
markAsRead |
将邮件标记为已读 |
用户信息
| 工具 | 说明 |
|---|---|
getUserStatus |
检查用户是否在线 |
getUserPhotos |
获取个人资料照片 |
媒体
| 工具 | 说明 |
|---|---|
searchGifs |
搜索GIF |
Nia搜索
| 工具 | 说明 |
|---|---|
searchPickupLines |
搜索索引的搭讪电话和约会建议 |
niaSearch |
通用语义搜索 |
webSearch |
实时网络搜索 |
AI工具
| 工具 | 说明 |
|---|---|
aiifyMessage |
将信息转化为诙谐的回应 |
MCP服务器工具（60+）
完整的Telegram API访问，包括：
- 聊天和群管理（创建、邀请、管理、禁止）
- 消息传递（发送、回复、编辑、删除、转发、固定、反应）
- 联系人管理（添加、搜索、阻止、导入/导出）
- 媒体和贴纸
- 隐私设置
- 还有更多。..
码头工人
docker build -t telegram-mcp:latest .
docker compose up --build
故障排除
- 数据库锁定错误：使用会话字符串身份验证，而不是基于文件的身份验证
- 身份验证错误：使用以下命令重新生成会话字符串
uv run session_string_generator.py - 连接问题：检查一下
telegram_api.py正在端口8765上运行 - 错误日志：检查
mcp_errors.log有关详细错误
安全
- 永远不要承诺你的
.env或会话字符串 - 会话字符串=完全Telegram帐户访问权限
- 所有处理均为本地处理，数据仅进入Telegram API
