Why it is worth attention

It demonstrates a practical, modular multi-agent system where specialized AI agents collaborate on software development tasks using Agent-to-Agent protocols, all orchestrated through a simple Telegram interface.

Who it is for

Developers wanting an AI-powered personal workspace
Technical project managers exploring multi-agent collaboration
Hobbyists interested in self-hosted agent swarms
Engineers familiar with Docker and Telegram bots

Use cases

Automating software development workflows (e.g., a TPM decomposing tasks for frontend, backend, and mobile agents)
Daily task planning and web queries via a general assistant
Personalized learning sessions with a companion agent
Managing multiple coding projects through a unified Telegram chat

Strengths

Modular folder structure with template-defined agent roles (dev, daily, TPM)
File-based A2A message bus enabling asynchronous inter-agent communication
Preconfigured Docker Compose with healthchecks and log rotation
Separate Telegram bots per agent for concurrent, isolated interactions

Considerations

Requires creating six separate Telegram bots and managing multiple API keys (OpenRouter, Anthropic, GitHub)
Setup involves multiple manual steps (.env configuration, permission restrictions)
Project has been migrated to another repository; this repo is no longer actively maintained

README quick start

⚠️ ANNOUNCEMENT: This project has been migrated to isfaaghyth/ghiath-ai. Future updates, releases, and maintenance will happen there.

isfa-ai: Multi-Agent Personal Workspace

This repository houses a fleet of NousResearch Hermes Agent instances configured to run via Docker Compose and communicate through Telegram.

Folder Structure

isfa-ai/
├── docker-compose.yml   # Optimized Docker services with log rotation & healthchecks
├── env.example          # Single entrypoint template for all configs & model variables
├── .env                 # Central secrets file (Ignored by Git)
├── setup.py             # Configuration generator & placeholder validator
├── setup.sh             # Executable shell runner with safety guards
├── .gitignore           # Git ignore rules for data, logs, and python caches
├── README.md            # This documentation
├── AGENT.md             # Global instructions, A2A protocols, and rules
├── OPINIONS.md          # Technical viewpoints & opinions
├── VOICE.md             # Tone and writing style guidelines
├── templates/           # System prompt (SOUL) templates
│   ├── dev_tpm/
│   ├── dev_kotlin_mobile/
│   ├── dev_golang_backend/
│   ├── dev_frontend_react/
│   ├── daily_general/
│   └── daily_learning_buddy/
├── skills/              # Reusable agent tools & instructions
│   ├── a2a/
│   ├── devops/
│   └── productivity/
└── data/                # Persistent runtime data (Ignored by Git)
    ├── .a2a/            # File-based Agent-to-Agent mailbox
    └── profiles/        # Contains active agent configurations and memory

Agent Directory & Personalities

Each agent has a custom system prompt (SOUL.md) preconfigured in the templates/ folder:

1. Technical Product Manager:

dev_tpm: The orchestrator. Decomposes tasks, designs implementation plans, and assigns subtasks to the developers via the A2A task board.

2. Development Agents:

dev_kotlin_mobile: Mobile Software Engineer specialized in Kotlin Multiplatform (KMP) and Compose Multiplatform.
dev_golang_backend: Backend Software Engineer specialized in Go (Golang) REST/gRPC microservices.
dev_frontend_react: Frontend Software Engineer specialized in React, Next.js, and Tailwind CSS.

3. Daily Agents:

daily_general: A standard da

Description

My agentic workflow template

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo

Featured

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents

2,390

slvDev

Featured

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models

1,960

littledivy

Featured

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning

1,482