# Iva

> Iva is an open-source, self-hosted Telegram AI assistant with a Markdown memory vault, voice transcription, image description, web search, and Google Workspace.

- **Category:** Chat
- **Licence:** MIT
- **Latest version:** eve-0.51.1-iva.5
- **Open source:** oss
- **Languages:** Typescript
- **Platforms:** Linux
- **Tags:** Privacy, Mcp, Telegram, Voice Assistant, Ai Assistant, Local First, LLM, Obsidian, Ollama, Knowledge Graph, Web Search, Typescript, Open Source, Google workspace, Telegram bot, Self Hosted, Agent, Ai Agent, Personal assistant, Long term memory, Personal ai, Second brain, Voice transcription, Personal CRM, Obsidian Compatible

## Description

Iva is a personal AI assistant that runs inside Telegram on your own server. You send it voice notes, photos, PDFs, and messages, and it organizes everything into a layered memory system: daily transcripts are condensed each night into weekly, monthly, and yearly digests, plus structured cards for people, projects, and choices. The memory lives in a private Git repository as plain Markdown, compatible with Obsidian. Iva transcribes voice with Deepgram nova-3, describes images using your chosen model provider's vision capability, searches the web via Tavily, Exa, Parallel, or Brave, and links to Google Workspace apps — Gmail, Calendar, Drive, Sheets, Docs, Tasks — through a guided setup. It supports multiple model providers: OpenCode Go, Ollama Cloud, OpenRouter, your ChatGPT subscription (via Codex), or a custom OpenAI-compatible endpoint. An optional userbot connects your personal Telegram account to read groups and reply as you, with server-enforced anti-ban guardrails. Security gates sanitize inbound content for prompt injection and redact secrets outbound. Installation is a single curl | bash command on Ubuntu/Debian or macOS, which installs system dependencies, Node 24+, builds the agent, and configures systemd user services. The local eve server listens on port 8723 (loopback only). No domain, HTTPS, or reverse proxy is required — Telegram long-polling handles transport. The project is MIT-licensed and actively maintained.

## Links

- [Homepage](https://github.com/smixs/iva-agent)
- [Website](https://iva-agent.com)
- [Documentation](https://github.com/smixs/iva-agent/blob/main/docs/install.md)
- [GitHub Repository](https://github.com/smixs/iva-agent)
- [Releases](https://github.com/smixs/iva-agent/releases)
- [Changelog](https://github.com/smixs/iva-agent/blob/main/CHANGELOG.md)
- [FAQ](https://github.com/smixs/iva-agent/blob/main/docs/faq.md)
- [Security Documentation](https://github.com/smixs/iva-agent/blob/main/docs/security.md)
- [Memory Architecture](https://github.com/smixs/iva-agent/blob/main/docs/memory.md)
- [Deploy Guide](https://github.com/smixs/iva-agent/blob/main/docs/deploy.md)
- [Use Cases](https://github.com/smixs/iva-agent/blob/main/docs/use-cases.md)

---
Source: https://selfhost.directory/project/iva-agent