gramwork is a tool that lets an AI take control of a regular Telegram account. It works like a helper that uses your real account, not a bot account. That means it can do everything a person can do on Telegram. It can send messages first, join groups, and interact without anyone knowing it is not a human.
This tool uses a Telegram library called Telethon. It connects to Telegram with full access. The AI can choose what to do, using smart decision-making based on the messages it sees.
- The AI makes its own decisions, calling tools and reading results.
- Can send messages, reply, forward, delete, and search chats.
- Supports joining and leaving groups.
- Works with smart AI models compatible with OpenAI and Ollama.
- Secures your secrets with AES-256 encryption.
- Runs on Windows and uses a normal Telegram user account.
- Windows 10 or later (64-bit recommended)
- 4 GB RAM minimum (8 GB or more works better)
- At least 200 MB of free disk space
- Internet connection for Telegram access and AI features
- A Telegram account (not a bot account)
Follow these steps to download and run gramwork on Windows.
Click the big green button above or this link below to visit the gramwork download page on GitHub.
On the page, look for the latest release or files section. Download the latest Windows installer or .exe file available. If there is no single installer, download the ZIP or setup files provided.
- If you have a setup file (like
.exe), double-click it. - Follow the instructions on your screen to install gramwork.
- If you downloaded a ZIP file, right-click it and select “Extract All” to a folder you choose.
You need a regular Telegram account, not a bot. Make sure you have the phone number and access to it.
- Find gramwork in your Start menu or the folder where you installed it.
- Run the program by double-clicking its icon.
- The app will ask you to enter your Telegram phone number.
- You may need to enter a code sent by Telegram on your phone to verify.
- This lets gramwork access your account securely.
Once connected, the AI agent can start working with your Telegram account. The AI decides which actions to take, like sending messages or joining groups, based on the setup.
gramwork uses a mix of software that lets the AI talk directly to Telegram. It works on top of Telethon, a Telegram client library. The AI runs loops that pick tools to use, get results, and make the next choice.
This means gramwork acts like a smart assistant that moves around your Telegram account as you define.
Telegram bots have limits. They cannot start conversations or join groups on their own. They also show a badge that tells people you are talking to a bot. gramwork controls a normal user account, so it works just like a person. This lets you automate tasks without restrictions.
Your data and secrets are kept safe with strong AES-256 encryption. This protects information like API keys or passwords. gramwork does not share your personal information without your control.
- If you cannot connect, check your internet connection.
- Make sure you use your Telegram number, not a bot token.
- If the AI does not seem to work, review your setup steps.
- For detailed logs, open the app’s help or debug section.
- If you find errors during install, try running as administrator.
- Select your AI provider (Ollama or OpenAI-compatible).
- Change the encryption password for your secrets vault.
- Adjust how often the AI checks messages.
- Enable or disable specific Telegram tools.
These settings help you customize the tool for your needs.
Check the GitHub page regularly for updates, new releases, and fixes. The project is active and may add more features over time.
Visit this link to get the latest version and full instructions:
Click the newest release or download option. After downloading, run the installer or unzip and open the program. Follow the steps above to connect your Telegram account.