nemati 0.1.2__tar.gz

nemati-0.1.2/.gitignore

@@ -0,0 +1,123 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+toturail

nemati-0.1.2/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-01-28
+
+### Added
+- Initial release
+- Chat completions with streaming support
+- AI Writer with templates
+- Image generation (text-to-image, image-to-image, upscale)
+- Audio (text-to-speech, speech-to-text)
+- Trend Discovery across multiple platforms
+- Market Intelligence for stocks and crypto
+- Document processing (upload, convert, chat)
+- Account management (credits, usage, limits)
+- Async client support
+- Comprehensive error handling
+- Full type hints
+
+[Unreleased]: https://github.com/nemati-ai/nemati-ai/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/nemati-ai/nemati-ai/releases/tag/v0.1.0

nemati-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NEMATI AI LLC
+
+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.

nemati-0.1.2/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: nemati
+Version: 0.1.2
+Summary: Official Python SDK for Nemati AI - AI Content Creation, Image Generation, Trend Discovery & More
+Project-URL: Homepage, https://nemati.ai
+Project-URL: Documentation, https://docs.nemati.ai/sdk/python
+Project-URL: Repository, https://github.com/nemati-ai/nemati
+Project-URL: Changelog, https://github.com/nemati-ai/nemati/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/nemati-ai/nemati/issues
+Author-email: NEMATI AI <support@nemati.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,chatgpt,content-creation,image-generation,nemati,openai,sdk,text-to-speech,trend-discovery
+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
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Nemati AI Python SDK
+
+[![PyPI version](https://badge.fury.io/py/nemati-ai.svg)](https://badge.fury.io/py/nemati-ai)
+[![Python Versions](https://img.shields.io/pypi/pyversions/nemati-ai.svg)](https://pypi.org/project/nemati-ai/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python SDK for [Nemati AI](https://nemati.ai) - Your all-in-one AI platform for content creation, image generation, trend discovery, and more.
+
+## Installation
+
+```bash
+pip install nemati-ai
+```
+
+## Quick Start
+
+```python
+from nemati import NematiAI
+
+# Initialize client
+client = NematiAI(api_key="your-api-key")
+
+# Chat completion
+response = client.chat.create(
+    messages=[
+        {"role": "user", "content": "What is machine learning?"}
+    ]
+)
+print(response.content)
+
+# AI Writer
+content = client.writer.generate(
+    prompt="Write a blog post about AI trends in 2026",
+    content_type="blog_post"
+)
+print(content.text)
+
+# Image Generation
+image = client.image.generate(
+    prompt="A futuristic city at sunset",
+    size="1024x1024"
+)
+image.save("city.png")
+```
+
+## Features
+
+- 🤖 **Chat Completions** - Conversational AI with multiple models
+- ✍️ **AI Writer** - Generate blogs, articles, social posts, and more
+- 🎨 **Image Generation** - Text-to-image, image-to-image, upscaling
+- 🔊 **Audio** - Text-to-speech and speech-to-text
+- 📈 **Trend Discovery** - Track trends across YouTube, TikTok, Reddit, and more
+- 📊 **Market Intelligence** - Stock and crypto data with AI analysis
+- 📄 **Document Processing** - Upload, convert, and chat with documents
+- ⚡ **Async Support** - Full async/await support for high-performance apps
+
+## Authentication
+
+Get your API key from [nemati.ai/dashboard/api-keys](https://nemati.ai/dashboard/api-keys).
+
+```python
+# Option 1: Pass directly
+client = NematiAI(api_key="nai_live_xxxxxxxxxxxx")
+
+# Option 2: Environment variable
+# Set NEMATI_API_KEY in your environment
+client = NematiAI()
+```
+
+## Usage Examples
+
+### Chat Completions
+
+```python
+# Simple chat
+response = client.chat.create(
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Explain quantum computing"}
+    ],
+    model="gpt-4",
+    max_tokens=1000
+)
+
+print(response.content)
+print(f"Tokens used: {response.usage.total_tokens}")
+
+# Streaming
+for chunk in client.chat.create(
+    messages=[{"role": "user", "content": "Write a poem about AI"}],
+    stream=True
+):
+    print(chunk.content, end="", flush=True)
+```
+
+### AI Writer
+
+```python
+# Generate content
+content = client.writer.generate(
+    prompt="Write a product description for an AI assistant app",
+    content_type="product_description",
+    tone="professional",
+    max_tokens=500
+)
+
+# Use templates
+templates = client.writer.templates.list()
+content = client.writer.templates.generate(
+    template_id="social-media-post",
+    variables={
+        "topic": "AI trends",
+        "platform": "LinkedIn"
+    }
+)
+```
+
+### Image Generation
+
+```python
+# Text to image
+image = client.image.generate(
+    prompt="A serene mountain landscape at dawn",
+    size="1024x1024",
+    quality="hd"
+)
+image.save("landscape.png")
+
+# Image to image
+edited = client.image.edit(
+    image=open("photo.jpg", "rb"),
+    prompt="Make it look like a watercolor painting"
+)
+
+# Upscale
+upscaled = client.image.upscale(
+    image=open("small.jpg", "rb"),
+    scale=4
+)
+```
+
+### Trend Discovery
+
+```python
+# Search trends
+trends = client.trends.search(
+    query="artificial intelligence",
+    platforms=["youtube", "tiktok", "reddit"],
+    timeframe="7d"
+)
+
+for trend in trends.items:
+    print(f"{trend.platform}: {trend.title}")
+    print(f"  Engagement: {trend.engagement}")
+```
+
+### Async Support
+
+```python
+import asyncio
+from nemati import AsyncNematiAI
+
+async def main():
+    client = AsyncNematiAI(api_key="your-api-key")
+    
+    response = await client.chat.create(
+        messages=[{"role": "user", "content": "Hello!"}]
+    )
+    print(response.content)
+    
+    await client.close()
+
+asyncio.run(main())
+```
+
+### Error Handling
+
+```python
+from nemati.exceptions import (
+    AuthenticationError,
+    RateLimitError,
+    InsufficientCreditsError,
+    ValidationError,
+    APIError
+)
+
+try:
+    response = client.chat.create(messages=[...])
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after} seconds")
+except InsufficientCreditsError as e:
+    print(f"Need {e.required} credits, have {e.available}")
+except ValidationError as e:
+    print(f"Invalid request: {e.errors}")
+except APIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+### Account & Usage
+
+```python
+# Check credits
+credits = client.account.credits()
+print(f"Remaining: {credits.remaining}")
+
+# Get usage stats
+usage = client.account.usage(
+    start_date="2026-01-01",
+    end_date="2026-01-31"
+)
+print(f"Total requests: {usage.total_requests}")
+
+# Get plan limits
+limits = client.account.limits()
+print(f"Chat messages/day: {limits.chat.max_messages_per_day}")
+```
+
+## Documentation
+
+Full documentation is available at [docs.nemati.ai/sdk/python](https://docs.nemati.ai/sdk/python)
+
+## Requirements
+
+- Python 3.8+
+- API key from [nemati.ai](https://nemati.ai)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- 📧 Email: support@nemati.ai
+- 💬 Discord: [discord.gg/nemati](https://discord.gg/nemati/KrFTV64NvS)
+- 🐛 Issues: [GitHub Issues](https://github.com/nematiai/nemati-ai/issues)

nemati-0.1.2/README.md

@@ -0,0 +1,237 @@
+# Nemati AI Python SDK
+
+[![PyPI version](https://badge.fury.io/py/nemati-ai.svg)](https://badge.fury.io/py/nemati-ai)
+[![Python Versions](https://img.shields.io/pypi/pyversions/nemati-ai.svg)](https://pypi.org/project/nemati-ai/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python SDK for [Nemati AI](https://nemati.ai) - Your all-in-one AI platform for content creation, image generation, trend discovery, and more.
+
+## Installation
+
+```bash
+pip install nemati-ai
+```
+
+## Quick Start
+
+```python
+from nemati import NematiAI
+
+# Initialize client
+client = NematiAI(api_key="your-api-key")
+
+# Chat completion
+response = client.chat.create(
+    messages=[
+        {"role": "user", "content": "What is machine learning?"}
+    ]
+)
+print(response.content)
+
+# AI Writer
+content = client.writer.generate(
+    prompt="Write a blog post about AI trends in 2026",
+    content_type="blog_post"
+)
+print(content.text)
+
+# Image Generation
+image = client.image.generate(
+    prompt="A futuristic city at sunset",
+    size="1024x1024"
+)
+image.save("city.png")
+```
+
+## Features
+
+- 🤖 **Chat Completions** - Conversational AI with multiple models
+- ✍️ **AI Writer** - Generate blogs, articles, social posts, and more
+- 🎨 **Image Generation** - Text-to-image, image-to-image, upscaling
+- 🔊 **Audio** - Text-to-speech and speech-to-text
+- 📈 **Trend Discovery** - Track trends across YouTube, TikTok, Reddit, and more
+- 📊 **Market Intelligence** - Stock and crypto data with AI analysis
+- 📄 **Document Processing** - Upload, convert, and chat with documents
+- ⚡ **Async Support** - Full async/await support for high-performance apps
+
+## Authentication
+
+Get your API key from [nemati.ai/dashboard/api-keys](https://nemati.ai/dashboard/api-keys).
+
+```python
+# Option 1: Pass directly
+client = NematiAI(api_key="nai_live_xxxxxxxxxxxx")
+
+# Option 2: Environment variable
+# Set NEMATI_API_KEY in your environment
+client = NematiAI()
+```
+
+## Usage Examples
+
+### Chat Completions
+
+```python
+# Simple chat
+response = client.chat.create(
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Explain quantum computing"}
+    ],
+    model="gpt-4",
+    max_tokens=1000
+)
+
+print(response.content)
+print(f"Tokens used: {response.usage.total_tokens}")
+
+# Streaming
+for chunk in client.chat.create(
+    messages=[{"role": "user", "content": "Write a poem about AI"}],
+    stream=True
+):
+    print(chunk.content, end="", flush=True)
+```
+
+### AI Writer
+
+```python
+# Generate content
+content = client.writer.generate(
+    prompt="Write a product description for an AI assistant app",
+    content_type="product_description",
+    tone="professional",
+    max_tokens=500
+)
+
+# Use templates
+templates = client.writer.templates.list()
+content = client.writer.templates.generate(
+    template_id="social-media-post",
+    variables={
+        "topic": "AI trends",
+        "platform": "LinkedIn"
+    }
+)
+```
+
+### Image Generation
+
+```python
+# Text to image
+image = client.image.generate(
+    prompt="A serene mountain landscape at dawn",
+    size="1024x1024",
+    quality="hd"
+)
+image.save("landscape.png")
+
+# Image to image
+edited = client.image.edit(
+    image=open("photo.jpg", "rb"),
+    prompt="Make it look like a watercolor painting"
+)
+
+# Upscale
+upscaled = client.image.upscale(
+    image=open("small.jpg", "rb"),
+    scale=4
+)
+```
+
+### Trend Discovery
+
+```python
+# Search trends
+trends = client.trends.search(
+    query="artificial intelligence",
+    platforms=["youtube", "tiktok", "reddit"],
+    timeframe="7d"
+)
+
+for trend in trends.items:
+    print(f"{trend.platform}: {trend.title}")
+    print(f"  Engagement: {trend.engagement}")
+```
+
+### Async Support
+
+```python
+import asyncio
+from nemati import AsyncNematiAI
+
+async def main():
+    client = AsyncNematiAI(api_key="your-api-key")
+    
+    response = await client.chat.create(
+        messages=[{"role": "user", "content": "Hello!"}]
+    )
+    print(response.content)
+    
+    await client.close()
+
+asyncio.run(main())
+```
+
+### Error Handling
+
+```python
+from nemati.exceptions import (
+    AuthenticationError,
+    RateLimitError,
+    InsufficientCreditsError,
+    ValidationError,
+    APIError
+)
+
+try:
+    response = client.chat.create(messages=[...])
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after} seconds")
+except InsufficientCreditsError as e:
+    print(f"Need {e.required} credits, have {e.available}")
+except ValidationError as e:
+    print(f"Invalid request: {e.errors}")
+except APIError as e:
+    print(f"API error {e.status_code}: {e.message}")
+```
+
+### Account & Usage
+
+```python
+# Check credits
+credits = client.account.credits()
+print(f"Remaining: {credits.remaining}")
+
+# Get usage stats
+usage = client.account.usage(
+    start_date="2026-01-01",
+    end_date="2026-01-31"
+)
+print(f"Total requests: {usage.total_requests}")
+
+# Get plan limits
+limits = client.account.limits()
+print(f"Chat messages/day: {limits.chat.max_messages_per_day}")
+```
+
+## Documentation
+
+Full documentation is available at [docs.nemati.ai/sdk/python](https://docs.nemati.ai/sdk/python)
+
+## Requirements
+
+- Python 3.8+
+- API key from [nemati.ai](https://nemati.ai)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Support
+
+- 📧 Email: support@nemati.ai
+- 💬 Discord: [discord.gg/nemati](https://discord.gg/nemati/KrFTV64NvS)
+- 🐛 Issues: [GitHub Issues](https://github.com/nematiai/nemati-ai/issues)