# Alpha-Bot

<p align="center">
  <strong><em>🤖 Your AI Task Automation Agent - Not Just Command Generator!</em></strong>
</p>

<p align="center">
  <strong>Describe complex tasks in plain language, and let AI execute them step-by-step until completion</strong>
</p>

<p align="center">
  <em>Multi-step execution • Auto-retry on failure • Real-time thinking display</em>
</p>

[![PyPI version](https://img.shields.io/pypi/v/alpha-bot.svg)](https://pypi.org/project/alpha-bot/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)

---

## Overview

Alpha-Bot is an **AI-powered task automation agent** that goes beyond simple command generation. Unlike tools that only translate single queries into commands, Alpha-Bot acts as an intelligent agent that can handle **multi-step tasks**, **learn from failures**, and **adapt its strategy** until your task is truly complete.

## What Makes Alpha-Bot Special?

**Not Just a Command Generator - A True Task Automation Agent!**

| Feature | Description |
|---------|-------------|
| 🔄 **Executes multi-step tasks** | from start to finish |
| 🧠 **Learns from failures** | and automatically retries |
| 💭 **Shows its thinking** | in real-time for transparency |
| ✅ **Doesn't stop** | until your task is complete |

## Why Alpha-Bot?

### Task-Oriented, Not Command-Oriented

| Other Tools | Alpha-Bot |
|------------|-----------|
| Generate ONE command → Done | Execute MULTIPLE steps → Analyze results → Adjust strategy → Complete task |
| "Here's your command, you run it" | "I'll keep working until the task is finished" |
| Fails? You figure it out | Fails? AI analyzes, retries, finds alternatives |

## Key Features

- 🤖 **Autonomous Task Agent** - Not just command generation, but complete task execution
- 🔄 **Smart Retry Loop** - Automatically recovers from failures and tries alternatives
- 💭 **Transparent AI Thinking** - Real-time display of AI's reasoning process
- 🧠 **Memory Mechanism** - Contextual memory bank for learning from previous steps
- 🧩 **Auto-Generated Skills** - Skills automatically created from markdown and persisted as Python files
- 🔬 **Revolutionary Auto Hints System** - Industry-first automatic skill optimization that learns from every execution
- 🎨 **Beautiful Interface** - Rich terminal output with animations and syntax highlighting
- 🔒 **Safety First** - Intelligent danger detection with user confirmation
- 🎯 **Multiple Modes** - Single execution, interactive mode, and auto mode
- 🧪 **Demo Mode** - Try it out without an API Key
- 🌐 **Browser Automation** - Built-in Playwright integration for web tasks
- 📊 **File Generation** - Create PPTs, images and other files from natural language
- 💬 **Communication Automation** - Feishu automation for macOS (WeChat automation available but currently disabled)
- 🔌 **Extensible Skills** - Plugin-ready architecture for adding new capabilities
- 🌐 **Web Interface** - Access Alpha-Bot through a web interface

## Quick Links

- [Installation Guide](getting-started/installation.md)
- [Quick Start Tutorial](getting-started/quick-start.md)
- [Configuration Options](getting-started/configuration.md)
- [Usage Examples](user-guide/examples.md)
- [Advanced Features](user-guide/advanced-features.md)
- [Safety Features](user-guide/safety.md)

## Demo Videos

Check out our [Examples](user-guide/examples.md) page to see Alpha-Bot in action!

## Tech Stack

- **Python 3.7+** - Easy to understand and extend
- **OpenAI API** - GPT-4 model (extensible to other LLMs)
- **Rich** - Beautiful terminal output with streaming support
- **python-dotenv** - Environment variable management

## License

This project is licensed under the MIT License - see the [LICENSE](https://github.com/fssqawj/alpha-bot/blob/main/LICENSE) file for details.

## Contributing

Issues and Pull Requests are welcome! See our [Contributing Guide](development/contributing.md) for details.
