Metadata-Version: 2.1
Name: hawkins-agent
Version: 0.1.1
Summary: A Python SDK for building AI agents with minimal code using Hawkins ecosystem with HawkinDB memory
Home-page: https://github.com/hawkins-ai/hawkins-agent
Author: Harish Santhanalakshmi Ganesan
License: MIT
Project-URL: Documentation, https://github.com/hawkins-ai/hawkins-agent#readme
Project-URL: Source, https://github.com/hawkins-ai/hawkins-agent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: flask[async]>=3.1.0
Requires-Dist: google-api-python-client>=2.156.0
Requires-Dist: hawkins-rag>=0.1.0
Requires-Dist: hawkinsdb>=1.0.1
Requires-Dist: litellm>=1.0.0
Requires-Dist: openai>=1.58.1
Requires-Dist: python-dotenv>=0.19.0
Requires-Dist: serpapi>=0.1.5
Requires-Dist: tavily-python>=0.5.0
Requires-Dist: trafilatura>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"

# Hawkins Agent Framework

A Python SDK for building AI agents with minimal code using the Hawkins ecosystem. This framework integrates key tools and services for building functional AI agents.

## Features

- **LiteLLM Integration**: Seamless support for multiple language models
- **Built-in Tools**:
  - Web Search capabilities using Tavily
  - Email functionality
  - Weather information
  - RAG (Retrieval-Augmented Generation)
  - Code interpretation
  - Text summarization
- **Memory Management**: Persistent memory system using HawkinDB
- **Multi-Agent Support**: Create and orchestrate multiple agents
- **Extensible Architecture**: Easy to add custom tools and capabilities

## Installation

```bash
pip install hawkins-agent
```

## Quick Start

```python
from hawkins_agent import AgentBuilder
from hawkins_agent.tools import WebSearchTool, RAGTool

# Create an agent with tools
agent = (AgentBuilder("research_assistant")
        .with_model("gpt-4o")
        .with_tool(WebSearchTool())
        .with_tool(RAGTool())
        .build())

# Process a query
response = await agent.process("Research the latest developments in AI")
print(response.message)
```

## Documentation

For detailed documentation, please visit:
- [API Reference](docs/api_reference.md)
- [Custom Tools Guide](docs/custom_tools.md)
- [Memory Management](docs/memory_management.md)

## Example Use Cases

- Research assistance
- Content generation
- Data analysis
- Task automation
- Multi-agent workflows

## Requirements

- Python 3.11 or higher
- Dependencies are automatically installed with the package

## License

MIT License

## Contributing

Contributions are welcome! Please check our contribution guidelines for more details.
