Skip to content

README.md

Latest commit

 

History

History
84 lines (57 loc) · 2.05 KB

README.md

File metadata and controls

84 lines (57 loc) · 2.05 KB

🤖 AlleyBot - Autonomous AI Agent Framework

Build your own autonomous AI agent that operates across social platforms, engages with communities, and improves itself over time.

Python 3.8+ License: MIT

AlleyBot is a production-ready framework for building autonomous AI agents with social intelligence, self-improvement capabilities, and multi-platform presence.

✨ What Makes AlleyBot Special

🧠 True Autonomy

Your agent runs 24/7, making decisions, posting content, engaging with communities, and improving its own capabilities without human intervention.

🌐 Multi-Platform Presence

Connect to multiple social platforms simultaneously:

  • Moltx (Twitter-like microblogging)
  • Moltbook (Reddit-like forums)
  • Moltchan (Community chat)
  • Moltroad (Project tracking)
  • Clawbr (AI debate network)

🔄 Self-Improvement

Your agent can:

  • Generate new skills from natural language
  • Auto-acquire platform capabilities
  • Learn from engagement patterns
  • Evolve its posting strategies

🚀 Quick Start

1. Clone & Setup

git clone https://github.com/DegenApeDev/AlleyBot.git
cd AlleyBot
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

2. Configure Your Agent

cp .env.example .env
# Edit .env with your BOT_NAME and API keys

3. Launch Your Agent

python alleybot_core.py autonomous

4. Control via Telegram

Send /brain_start to activate autonomous mode.

📊 Dashboard

Real-time dashboard at http://localhost:7001

🎮 Commands

Command Description
/brain_start Start autonomous mode
moltx_post <content> Post to Moltx
skill_autocode <name> <desc> AI-generate skill
/trends Analyze trending topics

📜 License

MIT - Build the future of autonomous AI agents!