gemini-agent-framework 0.1.10__py3-none-any.whl → 0.1.12__py3-none-any.whl

gemini_agent_framework-0.1.12.dist-info/METADATA

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: gemini-agent-framework
+Version: 0.1.12
+Summary: A framework for building agents that use Gemini's function calling capabilities
+Project-URL: Homepage, https://github.com/m7mdony/gemini-agent-framework
+Project-URL: Documentation, https://github.com/m7mdony/gemini-agent-framework/wiki
+Project-URL: Repository, https://github.com/m7mdony/gemini-agent-framework.git
+Project-URL: Issues, https://github.com/m7mdony/gemini-agent-framework/issues
+Author-email: Mohamed Baathman <mohamed.baathman2001@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: flake8>=6.0.0; extra == 'dev'
+Requires-Dist: isort>=5.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Gemini Agent Framework
+
+A powerful Python framework for building intelligent agents using Google's Gemini API. This framework simplifies the creation of agents that can break down complex tasks into sequential steps using available tools, with support for function calling, variable management, and structured responses.
+
+## Features
+
+- 🛠️ **Easy Tool Definition**: Define tools using simple decorators
+- 🔄 **Sequential Task Breakdown**: Automatically breaks down complex tasks into manageable steps
+- 📦 **Variable Management**: Store and manage variables with metadata
+- 🎯 **Structured Responses**: Define response structures for consistent outputs
+- 🔍 **Intermediate Results**: Access and manage intermediate results
+- 🛡️ **Error Handling**: Built-in error handling and recovery mechanisms
+- 🔌 **Extensible**: Easy to extend with custom tools and functionality
+
+## Installation
+
+```bash
+pip install gemini-agent-framework
+```
+
+## Quick Start
+
+```python
+from gemini_agent import Agent
+from dotenv import load_dotenv
+
+load_dotenv()
+
+# Define your tools
+@Agent.description("Multiplies two numbers.")
+@Agent.parameters({
+    'a': {'type': int, 'description': 'The first number'},
+    'b': {'type': int, 'description': 'The second number'}
+})
+def multiply(a: int, b: int) -> int:
+    return a * b
+
+# Create an agent instance
+agent = Agent(api_key="your-api-key", tools=[multiply])
+
+# Use the agent
+response = agent.prompt("Multiply 3 and 7")
+print(response)  # Should output 21
+```
+
+## Advanced Usage
+
+### Variable Management
+
+```python
+# Store variables with metadata
+agent.set_variable("user_name", "John", "The current user's name", str)
+agent.set_variable("last_login", datetime.now(), "Last login timestamp", datetime)
+
+# Retrieve variables
+name = agent.get_variable("user_name")
+```
+
+### Structured Responses
+
+```python
+response_structure = {
+    "result": {"type": "number"},
+    "explanation": {"type": "string"}
+}
+
+response = agent.prompt(
+    "Calculate 5 * 7 and explain the process",
+    response_structure=response_structure
+)
+```
+
+### Custom System Prompts
+
+```python
+system_prompt = """
+You are a helpful assistant that specializes in mathematical calculations.
+Always show your work and explain your reasoning.
+"""
+
+response = agent.prompt(
+    "Solve 15 * 23",
+    system_prompt=system_prompt
+)
+```
+
+## Documentation
+
+For detailed documentation, please visit our [documentation site](https://github.com/m7mdony/gemini-agent-framework/wiki).
+
+### Key Topics
+
+- [API Reference](https://m7mdony.github.io/gemini-agent-framework/api_refrences/)
+- [Tutorials](https://m7mdony.github.io/gemini-agent-framework/tutorials/)
+- [Best Practices](https://m7mdony.github.io/gemini-agent-framework/best_practices/)
+- [Architecture Overview](https://m7mdony.github.io/gemini-agent-framework/architecture/)
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
+
+### Development Setup
+
+1. Clone the repository
+2. Install development dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+3. Run tests:
+   ```bash
+   pytest
+   ```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- [GitHub Issues](https://github.com/m7mdony/gemini-agent-framework/issues)
+
+## Citation
+
+If you use this framework in your research, please cite:
+
+```bibtex
+@software{gemini_agent_framework,
+  author = {Mohamed Baathman},
+  title = {Gemini Agent Framework},
+  year = {2025},
+  url = {https://github.com/m7mdony/gemini-agent-framework}
+}
+``` 

gemini_agent_framework-0.1.12.dist-info/RECORD

@@ -0,0 +1,6 @@
+gemini_agent/__init__.py,sha256=huzUkDtkZ8p2huUAyUUvGsVkxicgsmFaODAG8CiwMmQ,69
+gemini_agent/agent.py,sha256=eY9Vjbew4N1dbY31oK37UVRb4a9w-StUUjCuAYCF8N8,26740
+gemini_agent_framework-0.1.12.dist-info/METADATA,sha256=q1jN4pSaNw-JB1mlVxHZmfdrasQkG5YktxDmCuKLvBU,5044
+gemini_agent_framework-0.1.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+gemini_agent_framework-0.1.12.dist-info/licenses/LICENSE,sha256=NHp9eKeWbB-Fp6Ff24BXSemJOa6UEZa9IAp9U7O9oBM,1073
+gemini_agent_framework-0.1.12.dist-info/RECORD,,

gemini_agent_framework-0.1.12.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Mohamed Baathman
+
+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. 

gemini_agent_framework-0.1.10.dist-info/METADATA

@@ -1,76 +0,0 @@
-Metadata-Version: 2.4
-Name: gemini-agent-framework
-Version: 0.1.10
-Summary: A framework for building agents that use Gemini's function calling capabilities
-Project-URL: Homepage, https://github.com/m7mdony/gemini-agent-framework
-Project-URL: Documentation, https://github.com/m7mdony/gemini-agent-framework#readme
-Project-URL: Repository, https://github.com/m7mdony/gemini-agent-framework.git
-Author-email: Mohamed Baathman <mohamed.baathman2001@gmail.com>
-License-Expression: MIT
-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.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.8
-Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: requests>=2.31.0
-Description-Content-Type: text/markdown
-
-# Gemini Agent Framework
-
-A Python framework for building agents that use Gemini's function calling capabilities. This framework allows you to easily create agents that can break down complex tasks into sequential steps using available tools.
-
-## Installation
-
-```bash
-pip install gemini-agent-framework
-```
-
-## Quick Start
-
-```python
-from gemini_agent import Agent
-from dotenv import load_dotenv
-
-load_dotenv()
-
-# Define your tools
-@Agent.description("Multiplies two numbers.")
-@Agent.parameters({
-    'a': {'type': int, 'description': 'The first number'},
-    'b': {'type': int, 'description': 'The second number'}
-})
-def multiply(a: int, b: int) -> int:
-    return a * b
-
-# Create an agent instance
-agent = Agent(api_key="your-api-key", tools=[multiply])
-
-# Use the agent
-response = agent.prompt("Multiply 3 and 7")
-print(response)  # Should output 21
-```
-
-## Features
-
-- Easy tool definition using decorators
-- Automatic sequential task breakdown
-- Support for structured responses
-- Intermediate result handling
-- Error handling and recovery
-
-## Documentation
-
-For more detailed documentation, please visit the [documentation page](https://github.com/yourusername/gemini-agent-framework#readme).
-
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## License
-
-This project is licensed under the MIT License - see the LICENSE file for details. 

gemini_agent_framework-0.1.10.dist-info/RECORD

@@ -1,5 +0,0 @@
-gemini_agent/__init__.py,sha256=rNKD-jP6y-Csd5s_LT_qIzwvteYe_23cYqoKf8vmyf0,72
-gemini_agent/agent.py,sha256=OINAAAw7VEUKS4NY5N-GItrt0McQVseRXyXv5Rw43AM,25883
-gemini_agent_framework-0.1.10.dist-info/METADATA,sha256=4lXbmc0Zm9NDhv8xbYe3tuMqkRnReuaB3xf4E1aqgI0,2387
-gemini_agent_framework-0.1.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-gemini_agent_framework-0.1.10.dist-info/RECORD,,