hands-on-ai 0.1.6

Hands-on AI Toolkit for classrooms

HandsOnAI: Your AI Learning Lab

AI learning made simple for students and educators

HandsOnAI is a unified educational toolkit designed to teach students how modern AI systems work — by building and interacting with them directly.

🔐 API Key Configuration

Environment Variable Method

# Set API key in your environment
export HANDS_ON_AI_API_KEY=your_secret_api_key_here

In-Code Configuration

from hands_on_ai import setup_colab

# Configure with API key
setup_colab(
    server_url="https://your-ollama-server.com",
    model="llama2",
    api_key="your_secret_api_key_here"
)

Secure API Key Management

# Verify API key configuration
from hands_on_ai.config import get_api_key

api_key = get_api_key()
if api_key:
    print("API key is configured successfully")
else:
    print("No API key found. Please configure.")

🧱 Module Overview

Module	Purpose	CLI Name
chat	Simple chatbot with system prompts	chat
rag	Retrieval-Augmented Generation (RAG)	rag
agent	ReAct-style reasoning with tool use	agent

🚀 Getting Started

Installation

# Install from PyPI
pip install hands-on-ai

# Or directly from GitHub
pip install git+https://github.com/teaching-repositories/hands-on-ai.git

Quick Start

from hands_on_ai.chat import get_response

# Basic usage with API key
response = get_response("Hello, how are you?")
print(response)

🛡️ Security Best Practices

• Never hardcode API keys in source code
• Use environment variables
• Rotate API keys periodically
• Use secure configuration management

📚 Documentation

• Chat Module Examples
• RAG Module Examples
• Agent Module Examples
• API Key Configuration

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details.