astraagent 2.25.6

package/.env.template

@@ -0,0 +1,22 @@
+# AstraAgent Environment Variables
+# Copy this file to .env and fill in your values
+
+# Local LLM Server Configuration
+LOCAL_API_KEY=your-api-key-here
+LOCAL_API_BASE=http://localhost:8000/api/v1
+LOCAL_MODEL=default
+
+# Alternative: OpenAI Configuration
+# OPENAI_API_KEY=sk-...
+# OPENAI_MODEL=gpt-4
+
+# Alternative: Anthropic Configuration
+# ANTHROPIC_API_KEY=sk-ant-...
+
+# Logging
+LOG_LEVEL=info
+
+# Workspace Paths
+WORKSPACE_PATH=./workspace
+ARTIFACTS_PATH=./artifacts
+TEMP_PATH=./temp

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AstraAgent Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,333 @@
+# 🚀 AstraAgent - Autonomous AI Agent Framework
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.9+-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/Status-Production_Ready-brightgreen.svg" alt="Status">
+</p>
+
+**AstraAgent** is a state-of-the-art autonomous AI agent framework designed to accomplish complex tasks with minimal human intervention. It rivals industry-leading agents from Google and OpenAI, featuring a modular architecture, comprehensive tool system, and advanced memory management.
+
+---
+
+## ✨ Key Features
+
+### 🧠 **Autonomous Problem Solving**
+- **OBSERVE → THINK → PLAN → ACT → REFLECT → ITERATE** workflow
+- Self-correcting behavior with error recovery
+- Dynamic plan adjustment based on results
+
+### 🔧 **Comprehensive Tool System**
+- **Shell**: Execute system commands safely
+- **File System**: Read, write, copy, delete files
+- **Python**: Execute code in sandboxed environment
+- **Web Search**: DuckDuckGo integration
+- **Web Fetch**: Extract content from URLs
+- **Browser**: Playwright-based automation
+- **Git**: Repository management
+- **Memory**: Persistent knowledge storage
+
+### 🧬 **Advanced Memory System**
+- Short-term, long-term, episodic, and semantic memory
+- Automatic memory consolidation
+- Similarity-based recall
+- Persistent storage with auto-save
+
+### 🛡️ **Safety Guardrails**
+- Dangerous command blocking
+- File extension restrictions
+- Execution timeout limits
+- Approval system for high-risk actions
+
+### 🔌 **Multi-Provider LLM Support**
+- **Grok/xAI** (grok-3, grok-3-fast, grok-3-mini) ⭐ NEW
+- OpenAI (GPT-4, GPT-4o, GPT-3.5)
+- Anthropic (Claude 3.5, Claude 3)
+- Local models (Ollama, LM Studio)
+
+---
+
+## 📦 Installation
+
+### Quick Install
+```bash
+pip install -e .
+```
+
+### Install via npm (global launcher)
+```bash
+npm install -g astraagent
+astraagent setup
+astraagent start -i
+```
+
+### With All Features
+```bash
+pip install -e ".[all]"
+```
+
+### Development Install
+```bash
+pip install -e ".[dev]"
+```
+
+### Browser Automation (optional)
+```bash
+pip install playwright
+playwright install chromium
+```
+
+---
+
+## 🚀 Quick Start
+
+### Set Your API Key
+```bash
+# Grok/xAI (recommended)
+set XAI_API_KEY=your-key-here          # Windows
+export XAI_API_KEY=your-key-here       # Linux/Mac
+
+# Or OpenAI
+set OPENAI_API_KEY=your-key-here       # Windows
+export OPENAI_API_KEY=your-key-here    # Linux/Mac
+```
+
+### Run the Agent
+```bash
+# Quick start alias (interactive)
+python main.py start -i
+
+# Run agent with a goal
+python main.py run "Create a Python script that generates prime numbers"
+
+# Run in interactive mode
+python main.py run -i
+
+# List available tools
+python main.py tools
+
+# Interactive multi-provider chat
+python main.py chat                    # Interactive selection
+python main.py chat --list-providers   # Show available providers
+
+# Update checker/auto updater
+python main.py update --check
+python main.py update --auto
+```
+
+###💬 Interactive Chat with Multiple LLM Providers
+
+**NEW:** Chat with GPT-4, Claude, Gemini, Ollama, and more!
+
+```bash
+# Start interactive chat mode
+python main.py chat
+
+# List available providers
+python main.py chat --list-providers
+```
+
+Supported providers:
+- 🆓 **Local** - Ollama, LM Studio (free, self-hosted)
+- **OpenAI** - GPT-4, GPT-4 Turbo, GPT-3.5
+- **Google Gemini** - Gemini 2.0 Flash, 1.5 Pro/Flash
+- **Anthropic Claude** - Claude 3.5 Sonnet, Claude 3 Opus
+- **OpenRouter** - Access 100+ models in one place
+- **Groq** - Fast inference (Mixtral, Llama, Gemma)
+
+See [CHAT_GUIDE.md](CHAT_GUIDE.md) for complete chat documentation.
+
+### Programmatic Usage
+```python
+import asyncio
+from astra import AstraAgent, AgentConfig
+
+async def main():
+    config = AgentConfig()
+    config.llm.provider = "openai"
+    config.llm.model = "gpt-4"
+    
+    agent = AstraAgent(config)
+    result = await agent.run("Write a web scraper for news headlines")
+    print(result)
+    agent.shutdown()
+
+asyncio.run(main())
+```
+
+---
+
+## 🛠️ Available Tools
+
+| Tool | Description | Risk Level |
+|------|-------------|------------|
+| `shell` | Execute shell commands | High |
+| `read_file` | Read file contents | Low |
+| `write_file` | Write/create files | Medium |
+| `list_dir` | List directory contents | Low |
+| `python` | Execute Python code | Medium |
+| `web_search` | Search the web | Low |
+| `google_search` | Search via Google | Low |
+| `exa_search` | Search via Exa API | Low |
+| `web_search_multi` | Multi-engine web search | Low |
+| `web_fetch` | Fetch URL content | Low |
+| `browser` | Browser automation | Medium |
+| `git` | Git operations | Medium |
+| `memory` | Store/recall information | Low |
+
+---
+
+## ⚙️ Configuration
+
+### Environment Variables
+```bash
+# API Keys (set one)
+XAI_API_KEY=xai-...          # Grok/xAI API key (recommended)
+OPENAI_API_KEY=sk-...        # OpenAI API key
+ANTHROPIC_API_KEY=sk-ant-... # Anthropic API key
+EXA_API_KEY=exa-...          # Exa search API key (optional)
+GOOGLE_CSE_API_KEY=...       # Google Custom Search API key (optional)
+GOOGLE_CSE_ID=...            # Google Custom Search engine ID (optional)
+
+# Configuration
+ASTRA_MODE=autonomous        # Execution mode
+ASTRA_MODEL=grok-3          # LLM model
+ASTRA_PROVIDER=grok         # LLM provider: grok, openai, anthropic, ollama
+ASTRA_MAX_ITERATIONS=50     # Max agent iterations
+```
+
+### Configuration File
+```python
+from astra import AgentConfig
+
+config = AgentConfig()
+config.llm.provider = "grok"    # or "openai", "anthropic", "ollama"
+config.llm.model = "grok-3"     # or "gpt-4", "claude-3-sonnet"
+config.llm.temperature = 0.7
+config.max_iterations = 100
+config.workspace_path = "./workspace"
+config.save("config.json")
+```
+
+---
+
+## 📁 Project Structure
+
+```
+AstraAgent/
+├── astra/
+│   ├── __init__.py
+│   ├── cli.py                 # Command-line interface
+│   ├── core/
+│   │   ├── agent.py           # Main agent class
+│   │   ├── config.py          # Configuration system
+│   │   ├── state.py           # State management
+│   │   └── memory.py          # Memory system
+│   ├── tools/
+│   │   ├── base.py            # Tool framework
+│   │   ├── shell.py           # Shell commands
+│   │   ├── file.py            # File operations
+│   │   ├── python.py          # Python execution
+│   │   ├── web.py             # Web search/fetch
+│   │   ├── browser.py         # Browser automation
+│   │   ├── git.py             # Git operations
+│   │   └── memory_tool.py     # Memory management
+│   └── llm/
+│       └── __init__.py        # LLM providers
+├── main.py                    # Entry point
+├── pyproject.toml             # Project config
+└── README.md
+```
+
+---
+
+## 🎯 Example Use Cases
+
+### 1. Code Generation
+```bash
+python main.py run "Create a FastAPI REST API with user authentication"
+```
+
+### 2. Data Analysis
+```bash
+python main.py run "Analyze the CSV files in ./data and create a report"
+```
+
+### 3. Web Research
+```bash
+python main.py run "Research the latest AI developments and summarize in a report"
+```
+
+### 4. Automation
+```bash
+python main.py run "Set up a new Python project with pytest and CI/CD"
+```
+
+### 5. Documentation
+```bash
+python main.py run "Generate API documentation for the src/ folder"
+```
+
+---
+
+## 🔒 Safety Features
+
+- **Command Blocking**: Prevents `rm -rf`, `format`, and other dangerous commands
+- **Sandboxed Execution**: Python code runs in restricted environment
+- **File Restrictions**: Blocks writes to system directories
+- **Timeout Limits**: Prevents infinite loops
+- **Approval Mode**: Optional user confirmation for risky actions
+
+---
+
+## 🧪 Development
+
+### Run Tests
+```bash
+pytest tests/
+```
+
+### Auto Update
+```bash
+python main.py update --check
+python main.py update --auto
+```
+
+### Format Code
+```bash
+black astra/
+ruff check astra/ --fix
+```
+
+---
+
+## 📊 Comparison
+
+| Feature | AstraAgent | ChatGPT | Google Agent |
+|---------|------------|---------|--------------|
+| Autonomous Execution | ✅ | ❌ | ✅ |
+| Local File Access | ✅ | ❌ | ❌ |
+| Shell Commands | ✅ | ❌ | ❌ |
+| Browser Automation | ✅ | ❌ | ✅ |
+| Persistent Memory | ✅ | Limited | ❌ |
+| Self-Hosted | ✅ | ❌ | ❌ |
+| Multi-Provider LLM | ✅ | ❌ | ❌ |
+| Extensible Tools | ✅ | Via Plugins | ❌ |
+
+---
+
+## 📜 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Acknowledgments
+
+Built with the power of modern LLMs and inspired by the vision of truly autonomous AI assistants.
+
+---
+
+<p align="center">
+  <b>AstraAgent</b> - The Future of Autonomous AI
+</p>

package/astra/__init__.py

@@ -0,0 +1,15 @@
+"""
+AstraAgent - Autonomous AI Agent Framework
+A comprehensive, state-of-the-art autonomous agent system.
+
+Author: AstraAgent Team
+Version: 2.25.6
+"""
+
+__version__ = "2.25.6"
+__author__ = "AstraAgent Team"
+
+from astra.core.agent import AstraAgent
+from astra.core.config import AgentConfig
+
+__all__ = ["AstraAgent", "AgentConfig", "__version__"]