{"id":29460718,"url":"https://github.com/vero-code/parla-agente","last_synced_at":"2026-05-19T03:19:29.375Z","repository":{"id":285142674,"uuid":"957054533","full_name":"vero-code/parla-agente","owner":"vero-code","description":"AI-powered agent that chats for you, keeps the conversation going, and sends you a smart summary. Stay social, without being constantly online. Built with agents, Gemini, and Telegram integration.","archived":false,"fork":false,"pushed_at":"2025-04-08T15:59:52.000Z","size":1446,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-14T03:01:20.946Z","etag":null,"topics":["agentverse","ai-agent","assistant","automation","chatbot","conversational-ai","fetch-ai","flask","gemini","hackathon","innovationlab","multiagent","python","summarization","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://devpost.com/software/parla-agente-speaks-for-you-and-does-it-beautifully","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vero-code.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-29T12:53:06.000Z","updated_at":"2025-04-08T16:06:28.000Z","dependencies_parsed_at":"2025-04-03T20:26:56.755Z","dependency_job_id":null,"html_url":"https://github.com/vero-code/parla-agente","commit_stats":null,"previous_names":["vero-git-hub/parla-agente","vero-code/parla-agente"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vero-code/parla-agente","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vero-code%2Fparla-agente","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vero-code%2Fparla-agente/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vero-code%2Fparla-agente/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vero-code%2Fparla-agente/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vero-code","download_url":"https://codeload.github.com/vero-code/parla-agente/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vero-code%2Fparla-agente/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32556771,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T00:31:16.350Z","status":"online","status_checked_at":"2026-05-03T02:00:09.297Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentverse","ai-agent","assistant","automation","chatbot","conversational-ai","fetch-ai","flask","gemini","hackathon","innovationlab","multiagent","python","summarization","telegram","telegram-bot"],"created_at":"2025-07-14T02:30:54.054Z","updated_at":"2026-05-03T02:42:59.680Z","avatar_url":"https://github.com/vero-code.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 🤖 Parla Agente\n\nAn AI agent that **chats on your behalf** and then sends you a short summary of the conversation. Parla Agente is a **multi-agent system** designed to simulate natural conversations and deliver concise summaries — so you don’t have to reply to every message.\n\nCreated for participation in the [Fetch.ai Hackathon](https://devpost.com/software/parla-agente-speaks-for-you-and-does-it-beautifully) \n![tag:innovationlab](https://img.shields.io/badge/innovationlab-3D8BD3)\n\n\n## 🧠 What the Agent Does\n\n![Architecture diagram](assets/diagram.png)\n\nThe three core agents — **Assistant Agent**, **Chat Agent**, and **Summary Agent** — are hosted on Agentverse and work together to handle each conversation.\n\nA fourth agent, the **Userbot Agent**, runs locally and acts as a bridge to your Telegram account. It intercepts incoming messages and forwards them to the Assistant Agent. From there, the Assistant dynamically locates suitable Chat and Summary agents to process and summarize the dialogue.\n\n### 1. `Chat Agent`\n_(hosted on Agentverse)_\n- Communicates in friendly style using **AI**\n- Generates natural, human-like replies\n\n### 2. `Summary Agent`\n_(hosted on Agentverse)_\n\n- Takes full conversation history and returns a **brief, friendly summary**\n- Uses **AI** to identify the real meaning behind casual chats\n\n### 3. `Assistant Agent`\n_(hosted on Agentverse)_\n\n- Coordinates the conversation\n- Sends your message to the Chat Agent\n- Collects replies and sends full history to Summary Agent when the dialogue ends\n- Supports dynamic agent **search and discovery feature** on Agentverse.ai\n\n### 4. `Userbot Agent`\n_(hosted on Agentverse, need connect to Mailbox)_\n\n- Connects to your Telegram account\n- Forwards messages to Assistant Agent\n- Receives and sends replies back via Telegram\n\n## 🔗 Live Agents on Agentverse\n\nYou can inspect the main agents running on [Agentverse.ai](https://agentverse.ai):\n\n- 🤖 Assistant Agent: [View agent](https://agentverse.ai/agents/details/agent1qw4gysgas39julunm3ejjles9lrfsqumjqqrs20yfh35lv6z3664yuk0u9u)\n- 💬 Chat Agent: [View agent](https://agentverse.ai/agents/details/agent1qttk8danzs0tuyj6drs332fxsk05z9acycakhrgyqxyxn0ky50yugvwcn6u)\n- 🧠 Summary Agent: [View agent](https://agentverse.ai/agents/details/agent1qvl93v59uh72cu3fc637h4rdnlgcmjkg3f0xccusykk8y6pdh7x86ttzln8)\n\n\u003e Agents are live and discover each other dynamically using `find_agent()`. You can test this flow by launching the `Userbot Agent` locally.\n\n## 📲 Telegram Integration\n\nChat with friends and family **without missing a beat**:\n- Parla Agente chats **on your behalf**\n- Leaves a good impression, respects your time\n- Avoids awkward “why aren’t you online?” moments\n\nHow it works:\n- The `Userbot Agent` connects to your Telegram account using **Telethon**\n- Incoming messages are automatically forwarded to the `Assistant Agent`\n- The `Chat Agent` responds in your tone\n- Replies are sent back via Telegram, just like you wrote them\n\n## 📝 Get a Quick Summary\n\nWant to know what your agent discussed without reading the whole chat?\n\n-   Just type `/summary` in your **Saved Messages** on Telegram.\n-   The Userbot Agent will trigger the **Summary Agent**.\n-   You’ll get a **short summary** of the conversation in your **Saved Messages** — private and convenient.\n\nThis helps you stay in the loop without opening every chat. ✨\n\n## 🔍 Agent Discovery\n\nInstead of hardcoding agent addresses, **Parla Agente** uses a custom `find_agent()` function to find agents dynamically.\n\nIt queries [Agentverse.ai](https://agentverse.ai/) for agents with specific tags like: `[\"innovationlab\"]`\n\nThat means:\n\n✔️ You don’t need to maintain static addresses  \n✔️ Parla Agente can connect to other participants' public agents  \n✔️ It’s easier to scale and add new agents in the future\n\n\n## 💡Example\n\nUser sends:\n\u003e \"Hey! How’s your work? Did you see the news today? Let's catch up soon.\"\n\nAI replies (via Chat Agent), maintains friendly tone and keeps conversation going.  \nWhen the chat ends, Summary Agent returns:\n\u003e \"**Summary:** Talked about work, the news, and planned to catch up soon. 🎯\"\n\n\n## ⚙️ Tech Stack\n\n- Python v3.13.2, pip v25.0.1\n\n- [Fetch.ai uAgents Framework](https://docs.fetch.ai/) v0.21.1\n\n- [Agentverse](https://agentverse.ai/) for agent discovery and hosting\n\n- [Google Gemini API](https://developers.google.com/gemini/docs/getting-started), [Gemini 2.0 Flash](https://www.google.com/search?q=gemini+2.0+flash) (Google's AI model)\n\n-  `.env` for secure API keys, VS Code editor\n\n- Telethon (Telegram API wrapper)\n\n\n## 🚀 How to Run\n\n\n### 1. Clone the repo and install dependencies:\n\n```bash\npython -m  venv  venv\nsource venv/bin/activate  # Windows: venv\\Scripts\\activate\npip install  -r  requirements.txt\n```\n\n### 2. Add your .env file (see `.env.example`):\n\nRequired variables:\n- `ASSISTANT_AGENT_HOSTED_ADDRESS`\n- `TG_API_ID` and `TG_API_HASH`\n\n#### ASSISTANT_AGENT_HOSTED_ADDRESS \nAlready specified, this is the public address of the Assistant Agent.\n\n#### TG_API_ID and TG_API_HASH\n\nYou can get these from [my.telegram.org](https://my.telegram.org).\n\n1. Log in with your Telegram account.\n2. Click **API Development Tools**.\n3. Fill in the form and click **Create application**.\n4. Copy your **App api_id** and **App api_hash**.\n\n[Full instructions](https://core.telegram.org/api/obtaining_api_id).\n\n### 3. Start the agents:\n\n```\npython userbot_agent.py\n```\nWhen you first launch Telethon, you will be asked to enter your phone number (of the account you want to “manage”) and a confirmation code from SMS or another Telegram client.\n\nIf two-factor authentication is enabled, you may also be asked for a password.\nAfter successful login, it will create a session file (eg userbot_session.session in the project root).\n\n📌 Note: When you run `userbot_agent.py` locally, it generates a unique agent address and connects to the public Mailbox.\n\nTo allow other agents (like the Assistant) to send messages back, you **must register your agent** in the mailbox network:\n\n1. Launch `userbot_agent.py` using the command above.\n2. Look for the printed link in the terminal, like:\n\n   https://agentverse.ai/inspect/?uri=http..\u0026address=agent1...\n\n3. Open the link in a browser and click **Connect**.\n\n\n## 💬 Use Case\n\nYour friend messages you.\nParla Agente chats with them in your tone.\nYou get a short summary like:\n_\"She wants to call you this evening.\"_\nNo stress. No overload. You stay connected ✨\n\n\n## 📈 Project Status\n\n✅ Chat Agent (Gemini)\n\n✅ Summary Agent (Gemini)\n\n✅ Assistant coordination logic\n\n✅ Multi-turn conversation flow\n\n✅ Auto-summary after dialogue\n\n✅ Connect to other agents on Agentverse\n\n✅ Telegram integration\n\n## 🛠️ Troubleshooting\n\nIf you don't receive messages back:\n- Make sure your Userbot Agent is connected to the Mailbox.\n- Confirm your Telegram account is properly logged in (check session file).\n- Check your `.env` file for correct API keys.\n\n## 📜 License\n\nThis project is licensed under the [MIT License](LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvero-code%2Fparla-agente","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvero-code%2Fparla-agente","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvero-code%2Fparla-agente/lists"}