Meez 0.3.4

Intention Detection

Detect user intentions from natural language:

import os
from meez.core import Langchain, Intention

# Setup
api_key = os.getenv("OPENAI_API_KEY")
langchain = Langchain(openai_api_key=api_key)

# Define intentions
intentions = [
    "greeting",
    "weather",
    "joke",
    "help",
    "goodbye",
    "book_appointment",
    "cancel_appointment",
    "unknown"
]

# Create detector
detector = Intention(langchain=langchain, intentions=intentions)

# Test inputs
test_texts = [
    "Hello there!",
    "What's the weather like?",
    "I need to book an appointment",
    "Can you help me cancel my appointment?"
]

for text in test_texts:
    intention = detector.detect(text)
    print(f"'{text}' → {intention}")

Contextual Responses

Generate responses based on context data:

from meez.core import Langchain, Respond
from meez.data import TextReader, JsonReader, FileReader

# Initialize
langchain = Langchain(openai_api_key=api_key)
respond = Respond(langchain)

# Using text data
text_data = "Artificial Intelligence is a branch of computer science..."
text_reader = TextReader(text_data)

response = respond.run(
    question="What is AI?",
    data=text_reader
)

# Using JSON data
json_data = {"company": {"name": "TechCorp", "employees": 250}}
json_reader = JsonReader(json_data)

response = respond.run(
    question="How many employees does the company have?",
    data=json_reader
)

# Using file data
file_reader = FileReader("documentation.txt")
response = respond.run(
    question="What are the main features?",
    data=file_reader
)

General Respond

Respond to general user questions using AI knowledge:

from meez.core import Langchain, GeneralRespond

# Initialize
langchain = Langchain(openai_api_key=api_key)
respond = GeneralRespond(langchain)

# Get response
question = "What is the capital of France?"
response = respond.run(question=question)
print(f"Response: {response}")

Workflow Automation with LangGraph

Create complex AI workflows:

from meez.core.langgraph import LangGraph, MainState
from meez.core import Langchain, Intention

# Define workflow nodes
def get_intent(state: MainState) -> MainState:
    # Detect user intention
    detector = Intention(langchain, ["get_phone", "get_email", "unknown"])
    intent = detector.detect(state["messages"][-1]["content"])
    state["messages"].append({"role": "assistant", "content": intent, "internal": True})
    return state

def decide(state: MainState) -> str:
    # Return the detected intent to determine next step
    return state["messages"][-1]["content"]

def get_phone(state: MainState) -> MainState:
    state["messages"].append({"role": "assistant", "content": "Phone: +1234567890"})
    return state

def get_email(state: MainState) -> MainState:
    state["messages"].append({"role": "assistant", "content": "Email: support@company.com"})
    return state

def unknown(state: MainState) -> MainState:
    state["messages"].append({"role": "assistant", "content": "I'm sorry, I don't know that."})
    return state

# Create and configure graph
graph = LangGraph()
graph.add_node("get_intent", get_intent)
graph.add_node("decide", decide)
graph.add_node("get_phone", get_phone)
graph.add_node("get_email", get_email)
graph.add_node("unknown", unknown)

graph.set_entry_point("get_intent")
graph.add_conditional_edge("get_intent", decide)
graph.add_finish_point("get_phone")
graph.add_finish_point("get_email")
graph.add_finish_point("unknown")

# Run workflow
initial_state = {"messages": [{"role": "user", "content": "What's your phone number?"}]}
result = graph.run(initial_state)

Setup Development Environment

# Clone the repository
git clone https://github.com/clivern/meez.git
cd meez

# Install development dependencies
pip install -r requirements.test.txt
pip install -e .

Running Tests

# Run tests
make ci