Metadata-Version: 2.4
Name: skt-ai-labs-adk
Version: 1.0.0
Summary: 🔥 SKT-AI-LABS Agent Development Kit - Production-grade AI Agents
Home-page: https://github.com/skt-ai-labs/skt-ai-labs-adk
Author: SKT-AI-LABS
Author-email: SKT-AI-LABS <dev@sktailabs.com>
License: MIT
Project-URL: Homepage, https://github.com/skt-ai-labs/skt-ai-labs-adk
Project-URL: Documentation, https://docs.sktailabs.com
Project-URL: Repository, https://github.com/skt-ai-labs/skt-ai-labs-adk
Project-URL: Issues, https://github.com/skt-ai-labs/skt-ai-labs-adk/issues
Keywords: ai,agents,llm,rag,langgraph,automation,research
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: langchain>=0.3.0
Requires-Dist: langgraph>=0.2.0
Requires-Dist: langchain-community>=0.3.0
Requires-Dist: google-generativeai>=0.8.0
Requires-Dist: openai>=1.0.0
Requires-Dist: groq>=0.9.0
Requires-Dist: tavily-python>=0.5.0
Requires-Dist: duckduckgo-search>=6.0.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: playwright>=1.40.0
Requires-Dist: requests>=2.31.0
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: sentence-transformers>=3.0.0
Requires-Dist: chromadb>=0.5.0
Requires-Dist: faiss-cpu>=1.8.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: websockets>=12.0
Requires-Dist: streamlit>=1.40.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: structlog>=24.0.0
Requires-Dist: tenacity>=8.2.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: markdown>=3.6.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.0.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: numpy>=1.26.0
Requires-Dist: pandas>=2.1.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: black>=24.0; extra == "dev"
Requires-Dist: ruff>=0.4.0; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Provides-Extra: browser
Requires-Dist: playwright>=1.40; extra == "browser"
Requires-Dist: selenium>=4.15; extra == "browser"
Provides-Extra: gpu
Requires-Dist: faiss-gpu>=1.8.0; extra == "gpu"
Requires-Dist: torch>=2.2.0; extra == "gpu"
Provides-Extra: all
Requires-Dist: skt-ai-labs-adk[browser,dev,gpu]; extra == "all"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# 🔥 SKT-AI-LABS Agent Development Kit (ADK)

> **The most powerful open-source AI Agent framework. Period.**
> 
> Built for hackathon winners. Built for production warriors.

[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![LangGraph](https://img.shields.io/badge/LangGraph-0.2+-green.svg)](https://langchain-ai.github.io/langgraph/)

## 🚀 What Makes SKT-AI-LABS ADK Different?

Unlike generic wrappers around OpenAI or Google APIs, **SKT-AI-LABS ADK** is a **complete agent operating system**:

| Feature | Others | SKT-AI-LABS ADK |
|---------|--------|-----------------|
| **Deep Research** | Single search call | Multi-step reasoning + recursive exploration |
| **RAG** | Basic retrieval | LangGraph-powered multi-hop reasoning |
| **Web Browser** | Static scraping | Live Playwright automation with anti-bot evasion |
| **Real-time** | Polling | WebSocket streaming + live data ingestion |
| **Error Handling** | Crash on failure | 3-tier taxonomy: Retryable/NonRetryable/Degraded |
| **Observability** | Print statements | Structured logging with full audit trails |
| **Multi-Agent** | Manual orchestration | Supervisor pattern with automatic routing |

## 📦 Installation

```bash
# Standard install
pip install skt-ai-labs-adk

# With browser automation support
pip install skt-ai-labs-adk[browser]

# Development install
pip install skt-ai-labs-adk[dev]
```

## 🎯 Quick Start

### 1. Deep Research Agent
```python
from skt_ai_labs import DeepResearchAgent

agent = DeepResearchAgent(
    model="gemini-2.5-pro",  # or "gpt-4o", "llama-3.3-70b"
    max_iterations=15,
    search_depth="deep"
)

report = await agent.research(
    "Latest quantum computing breakthroughs 2026"
)
print(report.markdown)
```

### 2. RAG Assistant with LangGraph
```python
from skt_ai_labs import RAGAssistantAgent

rag = RAGAssistantAgent(
    vector_store="chroma",  # or "pgvector", "faiss"
    embedding_model="sentence-transformers/all-MiniLM-L6-v2"
)

# Ingest documents
await rag.ingest(["docs/*.pdf", "docs/*.txt"])

# Chat with reasoning
response = await rag.chat(
    "What are the key findings about neural architecture search?",
    mode="deep"  # multi-hop reasoning
)
```

### 3. Web Browser Agent
```python
from skt_ai_labs import WebBrowserAgent

browser = WebBrowserAgent(headless=True)

# Navigate, interact, scrape
result = await browser.execute("""
1. Go to https://news.ycombinator.com
2. Find the top 5 stories about AI
3. Extract title, URL, and comment count
4. Return as structured JSON
""")
```

### 4. Real-time Streaming Agent
```python
from skt_ai_labs import RealtimeAgent

rt = RealtimeAgent(stream_type="websocket")

async for chunk in rt.process_stream("live_stock_data"):
    print(chunk.analysis)
```

### 5. Multi-Agent Team (Supervisor)
```python
from skt_ai_labs import SKTSupervisor, MultiAgentTeam

team = MultiAgentTeam(
    agents={
        "researcher": DeepResearchAgent(),
        "browser": WebBrowserAgent(),
        "rag": RAGAssistantAgent(),
    },
    supervisor=SKTSupervisor(strategy="adaptive")
)

result = await team.execute(
    "Research the latest AI trends, browse specific sites, and answer from our knowledge base"
)
```

## 🏗️ Architecture

```
┌─────────────────────────────────────────────────────────────────┐
│                    SKT-AI-LABS ADK                                │
├─────────────────────────────────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
│  │   Deep       │  │    RAG       │  │   Web        │          │
│  │   Research   │  │   Assistant  │  │  Browser     │          │
│  │   Agent      │  │   Agent      │  │   Agent      │          │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘          │
│         │                 │                 │                   │
│         └─────────────────┼─────────────────┘                   │
│                           │                                     │
│                    ┌──────┴──────┐                              │
│                    │  SKT        │                              │
│                    │ Supervisor  │                              │
│                    │  (Router)   │                              │
│                    └──────┬──────┘                              │
│                           │                                     │
│  ┌────────────────────────┼────────────────────────┐           │
│  │           TOOL LAYER   │                        │           │
│  │  ┌────────┐ ┌────────┐ │ ┌────────┐ ┌────────┐ │           │
│  │  │Search  │ │Browser │ │ │Scraper │ │Vector  │ │           │
│  │  │Engine  │ │Auto    │ │ │Intel.  │ │Store   │ │           │
│  │  └────────┘ └────────┘ │ └────────┘ └────────┘ │           │
│  └────────────────────────┼────────────────────────┘           │
│                           │                                     │
│  ┌────────────────────────┼────────────────────────┐           │
│  │         LLM LAYER      │                        │           │
│  │  Gemini │ GPT-4 │ Llama │ Claude │ Custom      │           │
│  └────────────────────────┴────────────────────────┘           │
└─────────────────────────────────────────────────────────────────┘
```

## 🔧 Configuration

Create `.env` file:
```env
# LLM APIs (at least one required)
GEMINI_API_KEY=your_gemini_key
OPENAI_API_KEY=your_openai_key
GROQ_API_KEY=your_groq_key

# Search APIs
TAVILY_API_KEY=your_tavily_key
BRAVE_API_KEY=your_brave_key
SERPAPI_KEY=your_serpapi_key

# Database (for RAG)
DATABASE_URL=postgresql://user:pass@localhost:5432/skt_db

# Vector Store
VECTOR_STORE_TYPE=chroma  # chroma, pgvector, faiss, redis
EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2

# Browser
PLAYWRIGHT_HEADLESS=true
BROWSER_TIMEOUT=30000
ANTI_BOT_ENABLED=true

# Agent Settings
MAX_ITERATIONS=15
MAX_CONCURRENT_SEARCHES=10
TOKEN_BUDGET=128000
LOG_LEVEL=INFO
```

## 📚 Documentation

- [Architecture Guide](docs/architecture.md)
- [Agent Development](docs/agents.md)
- [Tool Creation](docs/tools.md)
- [Deployment Guide](docs/deployment.md)
- [API Reference](docs/api.md)

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## 📄 License

MIT License - see [LICENSE](LICENSE) file.

---

**Built with ❤️ by SKT-AI-LABS** | *Winning hackathons since 2026*
