JARVIS Autonomous Agent

A fully autonomous AI agent that creates value without constant supervision. Self-improves, manages projects, and operates via Telegram.

Features

🧠 Complete Autonomy

• Continuous self-improvement via learning system
• Automatic hourly heartbeats
• Daily knowledge backup to GitHub
• Proactive task management

📱 Telegram Control

Six powerful commands:

• /create <name>

  - Create complete GitHub projects

• /backup

  - Manual backup of learnings

• /estado

  - Security system monitoring

• /heartbeat

  - Manual heartbeat execution

• /learnings

  - View recent learnings

• /help

  - Command list

🔄 Self-Improvement Loop

• Categorized learning system (best_practice, error_resolution, knowledge_gap)
• Automatic pattern promotion
• Persistent memory across sessions
• Error tracking and auto-correction

🚀 Automatic Project Generation

• Complete GitHub repository creation
• Base structure (README, .gitignore)
• Automatic push
• Project logging

Architecture

jarvis-autonomous/
├── SOUL.md           # Identity and principles
├── USER.md           # User profile
├── AGENTS.md         # Operations manual
├── MEMORY.md         # Long-term memory
├── TOOLS.md          # Tool configuration
├── .learnings/       # Learning system
│   ├── LEARNINGS.md
│   ├── ERRORS.md
│   └── FEATURE_REQUESTS.md
├── memory/           # Daily logs
├── scripts/          # Automation scripts
│   ├── heartbeat.sh
│   ├── self-improve.sh
│   ├── github-auto.sh
│   └── create-project.sh
└── notes/            # Proactive ideas

Setup

Prerequisites

• GitHub CLI authenticated:

  gh auth login

• Telegram bot token
• Python 3.8+ with asyncio

Installation

# Clone the workspace structure
mkdir -p ~/jarvis-autonomous
cd ~/jarvis-autonomous

# Create base files
cat > SOUL.md << 'SOULEOF'
# JARVIS - Autonomous AI Agent

## Identity
Autonomous AI agent specialized in:
- Self-directed project creation
- GitHub automation and CI/CD
- Proactive task generation
- Self-learning and adaptation

## Core Principles
1. Autonomy First - Anticipate, don't wait
2. Build, Don't Ask - Create solutions proactively
3. Learn Continuously - Every interaction improves
4. Fail Forward - Errors are learning data
5. Document Everything - Knowledge compounds
SOULEOF

# Create learnings directory
mkdir -p .learnings memory notes/areas scripts

# Copy scripts from skill folder
cp {baseDir}/scripts/*.sh ./scripts/
chmod +x ./scripts/*.sh

# Setup cron jobs
(crontab -l 2>/dev/null; echo "0 * * * * $HOME/jarvis-autonomous/scripts/heartbeat.sh") | crontab -

Telegram Bot Setup

1. Create bot via @BotFather
2. Get token
3. Configure in your bot code:

import sys
sys.path.append('/path/to/jarvis-autonomous')
from telegram_integration import JarvisTelegram

# Initialize
bot = JarvisTelegram(token="YOUR_TOKEN")
bot.run()

Usage Examples

Create a Project

/create my-awesome-app "An AI-powered productivity tool"

Manual Backup

/backup

Check System Status

/estado

Configuration

Environment variables:

• JARVIS_WORKSPACE

  - Path to workspace (default: ~/jarvis-autonomous)

• TELEGRAM_BOT_TOKEN

  - Your Telegram bot token

• GH_REPO

  - GitHub repo for backups

Tech Stack

• Python + AsyncIO
• Telegram Bot API (telebot)
• GitHub CLI (gh)
• Cron + Bash scripts
• ClawdHub skills (autonomous-feature-planner, self-improving-agent)

Integrations

Works with ClawdHub skills:

• autonomous-feature-planner

  - Plan features autonomously

• self-improving-agent

  - Enhanced self-improvement

• agent-orchestrator

  - Multi-agent coordination

• github-action-gen

  - CI/CD generation

Use Cases

1. Autonomous Development - Create and manage projects hands-free
2. Knowledge Preservation - Auto-backup learnings
3. Security Monitoring - Detect and report anomalies
4. Mobile Management - Full control via smartphone

Metrics

• 24/7 uptime with auto-restart
• 6 Telegram commands
• 2+ active cron jobs
• Continuous learning and improvement

License

MIT - Use, modify, distribute freely

Created By

Mariano (@apu242007) Built with Claude AI, Python, and determination.

---

"An agent that doesn't just execute commands—it anticipates your needs."