Metadata-Version: 2.4
Name: agredadb
Version: 2.0.0
Summary: Official Python Client for AgredaDB - The Limitless Database
Home-page: https://github.com/luisagreda-aidev/agredadb
Author: Luis Eduardo Agreda Gonzalez
Author-email: luisagreda.ai@gmail.com
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Provides-Extra: ml
Requires-Dist: torch>=1.9.0; extra == "ml"
Requires-Dist: numpy>=1.19.0; extra == "ml"
Provides-Extra: dev
Requires-Dist: pytest>=6.0.0; extra == "dev"
Requires-Dist: pytest-cov>=2.10.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# AgredaDB Python SDK

Official Python client for AgredaDB v2.0 - The Limitless Database.

## Installation

```bash
pip install agredadb
```

## Quick Start

```python
from agredadb import AgredaDBClient

# Connect to AgredaDB
client = AgredaDBClient("localhost:19999")

# Insert data
client.insert("users", {
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com",
    "vector": [0.1, 0.2, 0.3, 0.4],
    "metadata": {"type": "user"}
})

# Get data
user = client.get("users", "id", 1)
print(user)

# Vector search
results = client.search("users", 
    vector=[0.1, 0.2, 0.3, 0.4], 
    limit=10
)

# Close connection
client.close()
```

## Features

- ✅ Simple and intuitive API
- ✅ Vector similarity search
- ✅ Batch operations
- ✅ PyTorch/NumPy integration
- ✅ Context manager support
- ✅ Type hints

## Documentation

Full documentation available at: https://github.com/luisagreda-aidev/agredadb

## License

GNU Affero General Public License v3 (AGPLv3)

## Author

Luis Eduardo Agreda Gonzalez
- Email: luisagreda.ai@gmail.com
- LinkedIn: [luis-agreda-artificial-intelligence-engineer](https://www.linkedin.com/in/luis-agreda-artificial-intelligence-engineer)
