Metadata-Version: 2.4
Name: genai-starter-kit
Version: 0.2.0
Summary: 🚀 完整的生成式AI开发工具包，支持RAG、LLM和多模态AI功能
Home-page: https://github.com/YY-Nexus/GenerativeAI-Starter-Kit
Download-URL: https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/archive/main.zip
Author: YY-Nexus
Author-email: YY-Nexus <contact@yynexus.com>
Maintainer: YY-Nexus
Maintainer-email: YY-Nexus <contact@yynexus.com>
License: MIT
Project-URL: Homepage, https://github.com/YY-Nexus/GenerativeAI-Starter-Kit
Project-URL: Bug Reports, https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/issues
Project-URL: Source Code, https://github.com/YY-Nexus/GenerativeAI-Starter-Kit
Project-URL: Documentation, https://yy-nexus.github.io/GenerativeAI-Starter-Kit/
Project-URL: 中文文档, https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/blob/main/README.zh.md
Project-URL: Changelog, https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/blob/main/CHANGELOG.md
Project-URL: Repository, https://github.com/YY-Nexus/GenerativeAI-Starter-Kit.git
Project-URL: Download, https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/archive/main.zip
Keywords: generative-ai,rag,llm,transformers,openai,pytorch,fastapi,machine-learning,artificial-intelligence,multimodal,deep-learning
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
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: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Natural Language :: English
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Framework :: FastAPI
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: torch>=2.8.0
Requires-Dist: transformers>=4.56.2
Requires-Dist: numpy>=2.3.3
Requires-Dist: fastapi>=0.117.1
Requires-Dist: requests>=2.31.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: pillow>=9.0.0
Provides-Extra: rag
Requires-Dist: chromadb; extra == "rag"
Requires-Dist: milvus; extra == "rag"
Provides-Extra: multimodal
Requires-Dist: transformers; extra == "multimodal"
Requires-Dist: torch; extra == "multimodal"
Requires-Dist: opencv-python; extra == "multimodal"
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: build; extra == "dev"
Provides-Extra: all
Requires-Dist: genai-starter-kit[dev,multimodal,rag]; extra == "all"
Dynamic: author
Dynamic: download-url
Dynamic: home-page
Dynamic: license-file
Dynamic: maintainer
Dynamic: requires-python

# 🌟 GenerativeAI-Starter-Kit

🚀 **A comprehensive, beginner-friendly Generative AI development toolkit**

[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![CI/CD](https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/actions/workflows/ci-cd.yml)
[![Docker Build](https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/actions/workflows/docker-build.yml/badge.svg)](https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/actions/workflows/docker-build.yml)
[![CodeQL](https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/actions/workflows/codeql.yml/badge.svg)](https://github.com/YY-Nexus/GenerativeAI-Starter-Kit/actions/workflows/codeql.yml)

Welcome to **GenerativeAI-Starter-Kit**! This repository provides everything you need to get started with Generative AI—from basic concepts to production-ready applications. Perfect for learning, rapid prototyping, and real-world deployment.

---

## 🧠 What's Included

- **RAG (Retrieval-Augmented Generation)**: Build intelligent document Q&A systems
- **Multimodal Applications**: Work with text, images, and cross-modal tasks
- **Model Fine-tuning**: Adapt pre-trained models for specific domains
- **Production-Ready APIs**: FastAPI servers with full documentation

### 🛠️ Development Tools

- **One-Click Setup**: Automated environment configuration
- **Interactive Notebooks**: Step-by-step Jupyter tutorials
- **Configuration Management**: Easy YAML-based settings
- **Testing Framework**: Comprehensive test suites

### 📚 Learning Resources

- **Multi-language Docs**: Complete guides in English and Chinese
- **Progressive Tutorials**: From beginner to advanced
- **Best Practices**: Industry-standard approaches
- **Research Examples**: Latest techniques and methods

---

## 📦 Installation

### ✅ From PyPI (Recommended)

```bash
pip install genai-starter-kit
```

```python
from genai_starter_kit import chains, utils

response = chains.run_rag_query("What is retrieval-augmented generation?")
print(response)
```

---

### 🧪 From Source (Development Mode)

```bash
git clone https://github.com/YY-Nexus/GenerativeAI-Starter-Kit.git
cd GenerativeAI-Starter-Kit
pip install .
```

---

## 🚀 Quick Start

### 1️⃣ Clone & Setup

```bash
git clone https://github.com/YY-Nexus/GenerativeAI-Starter-Kit.git
cd GenerativeAI-Starter-Kit
./automation/setup.sh
source venv/bin/activate
```

### 2️⃣ Try the Examples

```bash

# RAG System Demo

python examples/rag/simple_rag.py

# Multimodal Web App

python examples/multimodal/image_text_app.py --web

# Fine-tuning Demo

python examples/fine-tuning/text_classification_tuning.py

# Start API Server

python automation/api_server.py
```

---

## 📚 Batch Run All Notebooks

```bash
pip install jupyter nbconvert
find RAG/notebooks -name "*.ipynb" -exec jupyter nbconvert --to notebook --execute --inplace {} \;
```

---

## 🗂️ Directory Structure

docs/                         # Documentation and usage guides (with Chinese docs in docs-zh)
RAG/                          # Retrieval-Augmented Generation module
community/                    # Community contributions and experimental resources
examples/                     # Example scripts and demos
scripts/                      # Automation and lint/test/release scripts
tests/                        # Unit tests
automation/                   # Setup and API server scripts
setup.py                      # Build configuration

---

## 🔧 Core Features

- End-to-end RAG examples (basic & advanced)
- Multimodal and industry-specific AI agents (text, speech, image, healthcare, finance, security)
- Model fine-tuning, training, evaluation, and safety (Llama, NeMo, Nemotron)
- Community resources, open-source contributions, and tutorials
- Comprehensive documentation (Chinese & English), one-click scripts, batch notebook execution

---

## 💼 Typical Use Cases

- Intelligent Q&A, knowledge retrieval, document analysis
- Multimodal interaction (speech, image, text)
- Industry-specific agents (healthcare, finance, security)
- Large model fine-tuning and safety evaluation

---

## ❓ FAQ & Help

- **Dependency install failed?** Check Python version or use a local mirror.
- **API service won't start?** Check port usage or run `python main.py --help` for options.
- **Notebooks won't batch run?** Ensure Jupyter and nbconvert are installed.

📖 See [`docs/README.md`](docs/README.md) or open a GitHub Issue for more help.

---

## 🤝 Contributing & Feedback

- Pull Requests welcome for code, docs, or examples
- Report issues with clear steps and environment details
- All contributions must comply with the [LICENSE](LICENSE)

---

## 📐 Standardization & Usability Commitment

- Unified script and doc formats with clear comments and step-by-step instructions
- Modular directory structure for easy navigation and extension
- Chinese and English documentation for global accessibility
- Continuous improvement—feedback is welcome!

---

This project is committed to making generative AI development easy for everyone.

**Join our community and start building today!**

---
