sumiki 0.1.0__tar.gz

sumiki-0.1.0/.env.example

@@ -0,0 +1,4 @@
+# Lyzr SDK Configuration
+
+# Your Lyzr API Key - Get it from https://studio.lyzr.ai
+LYZR_API_KEY=your-api-key-here

sumiki-0.1.0/.gitignore

@@ -0,0 +1,60 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+.venv/
+venv/
+ENV/
+env/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Build
+*.whl
+*.tar.gz
+
+# OS
+.DS_Store
+Thumbs.db
+
+# API docs and temp files
+api_docs/
+rag_docs/
+*.json
+!pyproject.toml
+!package.json
+
+# Examples environment
+examples/.venv/
+.env
+t

sumiki-0.1.0/LICENSE

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

sumiki-0.1.0/PKG-INFO

@@ -0,0 +1,292 @@
+Metadata-Version: 2.4
+Name: sumiki
+Version: 0.1.0
+Summary: Intuitive Python SDK for Lyzr Agent API - Build AI agents with ease
+Project-URL: Homepage, https://github.com/pradipta-lyzr/lyzr-sdk
+Project-URL: Documentation, https://docs.lyzr.ai/sdk
+Project-URL: Repository, https://github.com/pradipta-lyzr/lyzr-sdk
+Project-URL: Bug Tracker, https://github.com/pradipta-lyzr/lyzr-sdk/issues
+Author-email: Lyzr <support@lyzr.ai>
+Maintainer-email: Lyzr <support@lyzr.ai>
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,anthropic,artificial-intelligence,chatbot,gemini,google,llm,lyzr,machine-learning,openai
+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: 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.24.0
+Requires-Dist: json-repair>=0.7.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.0.0; python_version < '3.10'
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: ipython>=8.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: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Lyzr SDK
+
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**The official Python SDK for Lyzr - Build production-ready AI agents in minutes**
+
+Create powerful AI agents with a clean, intuitive API. Supports multiple LLM providers, knowledge bases (RAG), structured outputs, and streaming.
+
+## ✨ Features
+
+- 🚀 **Simple & Intuitive** - `agent.run("message")` - that's it!
+- 🎯 **Type-Safe** - Full Pydantic v2 validation with autocomplete
+- 🔌 **Modular** - Use what you need, extend what you want
+- 🤖 **Multi-Provider** - OpenAI, Anthropic, Google, Groq, Perplexity, AWS Bedrock
+- 📚 **Knowledge Bases** - Built-in RAG for documents, PDFs, websites
+- 🎨 **Structured Outputs** - Type-safe responses with Pydantic models
+- ⚡ **Streaming** - Real-time response streaming
+- 📦 **Production-Ready** - Robust error handling, retries, validation
+
+## 📦 Installation
+
+```bash
+pip install sumiki
+```
+
+## 🔑 Getting Your API Key
+
+Get your free API key from **[studio.lyzr.ai](https://studio.lyzr.ai)**
+
+Set it as an environment variable:
+```bash
+export LYZR_API_KEY="your-api-key-here"
+```
+
+## 🚀 Quick Start
+
+```python
+from lyzr import Studio
+
+# Initialize (uses LYZR_API_KEY from environment)
+studio = Studio()
+
+# Or pass API key directly
+studio = Studio(api_key="your-api-key-here")
+
+# Create an agent
+agent = studio.create_agent(
+    name="Customer Support Agent",
+    provider="openai/gpt-4o-mini"
+)
+
+# Run the agent
+response = agent.run("What are your business hours?")
+print(response.response)
+```
+
+## 📖 Core Features
+
+### 1. Smart Agents
+
+Agents are intelligent objects with built-in methods:
+
+```python
+# Create
+agent = studio.create_agent(
+    name="Sales Assistant",
+    provider="openai/gpt-4o",
+    temperature=0.7
+)
+
+# Run
+response = agent.run("Hello!")
+
+# Stream
+for chunk in agent.run("Tell me about your products", stream=True):
+    print(chunk.content, end="")
+
+# Update
+agent = agent.update(temperature=0.5)
+
+# Clone
+new_agent = agent.clone("Sales Assistant V2")
+
+# Delete
+agent.delete()
+```
+
+### 2. Structured Outputs with Pydantic
+
+Get type-safe, validated responses:
+
+```python
+from pydantic import BaseModel
+from typing import Literal
+
+class SentimentAnalysis(BaseModel):
+    sentiment: Literal["positive", "negative", "neutral"]
+    confidence: float
+    reasoning: str
+
+agent = studio.create_agent(
+    name="Sentiment Analyzer",
+    provider="openai/gpt-4o",
+    response_model=SentimentAnalysis
+)
+
+# Get typed response
+result: SentimentAnalysis = agent.run("I love this product!")
+print(result.sentiment)  # "positive" - fully typed!
+print(result.confidence)  # 0.95
+```
+
+### 3. Knowledge Bases (RAG)
+
+Create knowledge bases and use them with agents:
+
+```python
+# Create knowledge base
+kb = studio.create_knowledge_base(
+    name="product_docs",
+    vector_store="qdrant"
+)
+
+# Add documents
+kb.add_pdf("user_manual.pdf")
+kb.add_docx("policies.docx")
+kb.add_website("https://docs.mycompany.com", max_pages=50)
+kb.add_text("FAQ: Business hours are 9am-5pm", source="faq.txt")
+
+# Query directly
+results = kb.query("How do I reset my password?", top_k=3)
+
+# Use with agent at runtime
+agent = studio.create_agent(
+    name="Support Bot",
+    provider="openai/gpt-4o"
+)
+
+response = agent.run(
+    "What are your business hours?",
+    knowledge_bases=[kb]  # ← Pass KB at runtime
+)
+```
+
+### 4. Multiple Providers
+
+```python
+# OpenAI
+agent = studio.create_agent(name="Bot", provider="openai/gpt-4o")
+
+# Anthropic
+agent = studio.create_agent(name="Bot", provider="anthropic/claude-sonnet-4-5")
+
+# Google
+agent = studio.create_agent(name="Bot", provider="google/gemini-2.5-pro")
+
+# Auto-detect provider
+agent = studio.create_agent(name="Bot", provider="gpt-4o")
+```
+
+## 🌟 Supported Models
+
+### LLM Providers
+- **OpenAI**: GPT-4o, GPT-5, o3, o4-mini
+- **Anthropic**: Claude Sonnet 4.5, Claude Opus 4.5
+- **Google**: Gemini 2.5 Pro, Gemini 3 Pro Preview
+- **Groq**: Llama 3.3, Llama 4
+- **Perplexity**: Sonar, Sonar Pro (with web search)
+- **AWS Bedrock**: Amazon Nova, Claude via Bedrock
+
+### Vector Stores (Knowledge Bases)
+- Qdrant, Weaviate, PG-Vector, Milvus, Amazon Neptune
+
+## 📚 Examples
+
+See the `/examples` folder for complete working examples:
+
+- `quickstart.py` - Basic agent creation and usage
+- `structured_responses.py` - Pydantic models for typed outputs
+- `knowledge_base_basic.py` - Creating and managing knowledge bases
+- `kb_with_agent.py` - Using KBs with agents at runtime
+
+## 🛠️ Advanced Usage
+
+### Multiple Knowledge Bases
+
+```python
+products_kb = studio.create_knowledge_base(name="products")
+policies_kb = studio.create_knowledge_base(name="policies")
+
+# Use multiple KBs with custom config
+response = agent.run(
+    "What's the refund policy for Product X?",
+    knowledge_bases=[
+        products_kb.with_config(top_k=5, score_threshold=0.8),
+        policies_kb.with_config(top_k=3, retrieval_type="mmr")
+    ]
+)
+```
+
+### Session Management
+
+```python
+# Auto-generated session
+response = agent.run("Hello")
+
+# Explicit session for continuity
+session_id = "user_123"
+response1 = agent.run("Question 1", session_id=session_id)
+response2 = agent.run("Follow-up", session_id=session_id)
+```
+
+## 🐛 Error Handling
+
+```python
+from lyzr.exceptions import (
+    AuthenticationError,
+    ValidationError,
+    NotFoundError,
+    InvalidResponseError
+)
+
+try:
+    agent = studio.create_agent(name="Bot", provider="invalid/model")
+except ValidationError as e:
+    print(f"Error: {e.message}")
+```
+
+## 🤝 Contributing
+
+Contributions welcome! Please submit a Pull Request.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file
+
+## 🔗 Links
+
+- **Get API Key**: [studio.lyzr.ai](https://studio.lyzr.ai)
+- **Documentation**: [docs.lyzr.ai](https://docs.lyzr.ai)
+- **GitHub**: [github.com/pradipta-lyzr/lyzr-sdk](https://github.com/pradipta-lyzr/lyzr-sdk)
+- **PyPI**: [pypi.org/project/sumiki](https://pypi.org/project/sumiki)
+- **Website**: [lyzr.ai](https://lyzr.ai)
+
+## 💬 Support
+
+- Email: support@lyzr.ai
+- GitHub Issues: [github.com/pradipta-lyzr/lyzr-sdk/issues](https://github.com/pradipta-lyzr/lyzr-sdk/issues)
+
+---
+
+Built with ❤️ by [Lyzr](https://lyzr.ai)

sumiki-0.1.0/PUBLISHING.md

@@ -0,0 +1,140 @@
+# Publishing Sumiki (Lyzr SDK) to PyPI
+
+**PyPI Package Name**: sumiki
+**Import Name**: from lyzr import Studio
+**Install**: pip install sumiki
+
+## Quick Guide
+
+### 1. Install Build Tools
+```bash
+uv pip install build twine
+```
+
+### 2. Clean Previous Builds
+```bash
+rm -rf dist/ build/ *.egg-info
+```
+
+### 3. Build the Package
+```bash
+uv build
+# Or: python3 -m build
+```
+
+This creates:
+- `dist/sumiki-0.1.0.tar.gz`
+- `dist/sumiki-0.1.0-py3-none-any.whl`
+
+### 4. Check the Package
+```bash
+twine check dist/*
+```
+
+### 5. Upload to PyPI
+
+**Option A: Using API Token**
+```bash
+# Set token as environment variable
+export TWINE_USERNAME=__token__
+export TWINE_PASSWORD=pypi-YOUR-API-TOKEN-HERE
+
+# Upload
+twine upload dist/*
+```
+
+**Option B: Interactive**
+```bash
+twine upload dist/*
+# Username: __token__
+# Password: pypi-YOUR-TOKEN
+```
+
+### 6. Verify Installation
+```bash
+pip install sumiki
+python3 -c "from lyzr import Studio; print('Success!')"
+```
+
+---
+
+## Testing on TestPyPI First (Recommended)
+
+```bash
+# Upload to TestPyPI
+twine upload --repository testpypi dist/*
+
+# Test install
+pip install --index-url https://test.pypi.org/simple/ sumiki
+
+# Test it works
+python3 -c "from lyzr import Studio; print('Works!')"
+```
+
+---
+
+## Complete Workflow
+
+```bash
+# 1. Update version
+# Edit pyproject.toml and lyzr/__init__.py
+
+# 2. Clean and build
+rm -rf dist/ build/ *.egg-info
+uv build
+
+# 3. Check
+twine check dist/*
+
+# 4. Test on TestPyPI (optional)
+twine upload --repository testpypi dist/*
+
+# 5. Upload to PyPI
+export TWINE_USERNAME=__token__
+export TWINE_PASSWORD=pypi-YOUR-TOKEN
+twine upload dist/*
+
+# 6. Test installation
+pip install sumiki
+```
+
+---
+
+## PyPI Credentials
+
+### Get API Token
+1. Go to https://pypi.org/manage/account/
+2. Scroll to "API tokens"
+3. Click "Add API token"
+4. Name: "lyzr-sdk"
+5. Scope: "Entire account"
+6. Copy the token (starts with `pypi-`)
+
+### Configure ~/.pypirc (Optional)
+```bash
+cat > ~/.pypirc << 'EOF'
+[pypi]
+username = __token__
+password = pypi-YOUR-TOKEN-HERE
+EOF
+
+chmod 600 ~/.pypirc
+```
+
+---
+
+## Version Updates
+
+Before each release, update version in:
+1. `pyproject.toml` - `version = "0.1.1"`
+2. `lyzr/__init__.py` - `__version__ = "0.1.1"`
+
+---
+
+## Package Name
+
+- **PyPI Name**: `lyzr`
+- **Import Name**: `from lyzr import Studio`
+- **Install**: `pip install sumiki`
+
+Done! 🎉