Metadata-Version: 2.4
Name: agent-zero-lite
Version: 1.0.8
Summary: Lightweight Python AI Agent Framework with Web UI
Home-page: https://github.com/frdel/agent-zero-lite
Author: Agent Zero Community
Author-email: Agent Zero Community <support@agent-zero.io>
Maintainer-email: Agent Zero Community <support@agent-zero.io>
License: MIT
Project-URL: Homepage, https://github.com/frdel/agent-zero-lite
Project-URL: Documentation, https://github.com/frdel/agent-zero-lite#readme
Project-URL: Repository, https://github.com/frdel/agent-zero-lite
Project-URL: Bug Reports, https://github.com/frdel/agent-zero-lite/issues
Project-URL: Changelog, https://github.com/frdel/agent-zero-lite/blob/main/CHANGELOG.md
Keywords: ai,agent,llm,python,automation,web-ui,litellm,openai,anthropic
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiofiles
Requires-Dist: anthropic
Requires-Dist: beautifulsoup4
Requires-Dist: chromadb
Requires-Dist: cryptography
Requires-Dist: fastapi
Requires-Dist: faiss-cpu>=1.11.0
Requires-Dist: fastmcp>=2.3.4
Requires-Dist: flask[async]>=3.0.3
Requires-Dist: flask-basicauth
Requires-Dist: google-generativeai
Requires-Dist: httpx
Requires-Dist: langchain
Requires-Dist: langchain-community>=0.3.19
Requires-Dist: langchain-core>=0.3.49
Requires-Dist: langchain-openai
Requires-Dist: litellm>=1.74
Requires-Dist: mcp>=1.9.0
Requires-Dist: nest-asyncio
Requires-Dist: numpy
Requires-Dist: openai
Requires-Dist: openai-whisper>=20240930
Requires-Dist: packaging
Requires-Dist: paramiko>=3.5.0
Requires-Dist: pillow
Requires-Dist: psutil>=7.0.0
Requires-Dist: pydantic
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: python-multipart
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: sentence-transformers>=3.0.1
Requires-Dist: simpleeval>=1.0.3
Requires-Dist: tiktoken>=0.8.0
Requires-Dist: uvicorn
Requires-Dist: watchdog
Requires-Dist: webcolors>=24.6.0
Requires-Dist: pytz>=2024.2
Requires-Dist: GitPython>=3.1.43
Requires-Dist: inputimeout>=1.0.4
Requires-Dist: pathspec>=0.12.1
Requires-Dist: a2wsgi>=1.10.8
Requires-Dist: ansio>=0.0.1
Requires-Dist: fasta2a>=0.5.0
Requires-Dist: flaredantic>=0.1.4
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.4.0; extra == "docs"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Agent Zero Lite

A lightweight, cross-platform implementation of Agent Zero that maintains core functionality while reducing complexity and dependencies.

## Features

✅ **Full LiteLLM Support** - 100+ AI providers (OpenAI, Anthropic, Google, local models, etc.)  
✅ **Web UI** - Complete interface at localhost:50001  
✅ **Vector Memory** - FAISS-based persistent memory  
✅ **Document RAG** - PDF, text, and document processing  
✅ **Multi-Agent** - Superior/subordinate agent hierarchy  
✅ **MCP Client** - Model Context Protocol integration  
✅ **Local Execution** - Python, Node.js, and terminal  
✅ **Tunneling** - Remote access support  
✅ **File Management** - Work directory browser  

## Removed from Full Version

❌ Browser automation (Playwright)  
❌ Docker/SSH execution  
❌ Speech processing (STT/TTS)  
❌ Task scheduling  
❌ Backup/restore system  
❌ Web search tools  

## Quick Start

1. **Install dependencies:**
   ```bash
   pip install -r requirements.txt
   ```

2. **Configure environment:**
   ```bash
   cp .env.example .env
   # Edit .env with your API keys
   ```

3. **Start the Web UI:**
   ```bash
   python run_ui.py
   ```

4. **Open browser:**
   ```
   http://localhost:50001
   ```

## Configuration

### Minimal Setup
Set at least one LLM provider in `.env`:

```bash
# OpenAI
OPENAI_API_KEY=sk-...

# Or Anthropic
ANTHROPIC_API_KEY=sk-ant-...

# Or local Ollama
CHAT_MODEL_PROVIDER=ollama
CHAT_MODEL_NAME=llama3.1:8b
OLLAMA_API_BASE=http://localhost:11434
```

### Full Configuration
See `.env.example` for all available options including:
- All 100+ LiteLLM providers
- Model configurations  
- Rate limiting settings
- MCP server integration
- Memory and knowledge settings

## Supported Models

Agent Zero Lite supports **all LiteLLM providers**:

### Commercial APIs
- **OpenAI:** GPT-4o, GPT-4, GPT-3.5, etc.
- **Anthropic:** Claude 3.5 Sonnet, Claude 3 Opus, etc.
- **Google:** Gemini 1.5 Pro, Gemini 1.5 Flash, etc.
- **Groq:** Llama 3.1, Mixtral, etc. (fast inference)
- **Together AI:** Llama, Mistral, etc.
- **Mistral AI:** Mistral Large, Mistral 7B, etc.
- **Cohere:** Command R+, Command Light, etc.

### Local Models
- **Ollama:** Any local model (llama3.1, mistral, etc.)
- **LM Studio:** Local model server
- **Text Generation WebUI:** Local inference
- **VLLM:** High-performance inference server

### Enterprise
- **Azure OpenAI:** Enterprise GPT models
- **AWS Bedrock:** Claude, Titan, etc.
- **Google Vertex AI:** Enterprise Gemini
- **Hugging Face:** Hosted models

## Usage Examples

### Basic Chat
```python
from agent import AgentContext
import initialize

# Initialize agent
config = initialize.initialize_agent()
context = AgentContext(config)

# Send message
response = context.communicate("Hello, what can you help me with?")
```

### Code Execution
The agent can execute Python, Node.js, and terminal commands:

```
User: "Create a Python script that calculates fibonacci numbers"
Agent: Uses code_execution tool to write and run Python code
```

### Document Processing
```
User: "Analyze this PDF document and summarize the key points"
Agent: Uses document_query tool to process and analyze documents
```

### Multi-Agent Collaboration
```
User: "Create a complex analysis using multiple specialized agents"
Agent: Uses call_subordinate to delegate tasks to specialized sub-agents
```

## Architecture

Agent Zero Lite maintains the core Agent Zero architecture:

- **Agent Loop:** Reason → Tool Use → Response cycle
- **Tool System:** Extensible plugin architecture  
- **Memory:** FAISS vector database for persistent memory
- **Extensions:** Hook-based system for customization
- **Prompts:** Template-based prompt management

## Development

### Adding Tools
Create new tools in `python/tools/`:

```python
from python.helpers.tool import Tool, Response

class MyTool(Tool):
    async def execute(self, **kwargs):
        # Tool logic here
        return Response(message="result", break_loop=False)
```

### Adding Extensions
Create extensions in `python/extensions/`:

```python
from python.helpers.extension import Extension

class MyExtension(Extension):
    async def execute(self, **kwargs):
        # Extension logic here
        pass
```

## Troubleshooting

### Common Issues

1. **Model not responding:** Check API keys in `.env`
2. **Port in use:** Change PORT in `.env` 
3. **Memory issues:** Reduce context length settings
4. **Missing dependencies:** Run `pip install -r requirements.txt`

### Debugging

Enable debug logging by setting:
```bash
LITELLM_LOG=DEBUG
```

## Migration

### From Full Agent Zero
1. Copy `.env` settings
2. Copy `memory/` and `knowledge/` folders  
3. Copy `work_dir/` contents
4. Remove Docker/SSH configurations

### To Full Agent Zero  
1. Install additional dependencies
2. Add Docker/SSH configurations
3. No data migration needed

## Performance

Agent Zero Lite is optimized for:
- **Startup:** ~3 seconds vs 15+ seconds
- **Memory:** ~200MB vs 1GB+ RAM usage  
- **Dependencies:** ~30 packages vs 45+ packages
- **Installation:** <2 minutes vs 10+ minutes

## License

Same as Agent Zero - check the original repository for license terms.

## Support

For issues and questions:
1. Check this README
2. Review `.env.example` configuration
3. See the original Agent Zero documentation
4. Report issues to the Agent Zero repository
