from cerevox import Hippo

# Initialize Hippo
hippo = Hippo(api_key="your-api-key")

# 1. Create folder
folder = hippo.create_folder(
    name="Product Documentation",
    description="User guides and API docs"
)

# 2. Upload files
file1 = hippo.upload_file(folder.id, "user-guide.pdf")
file2 = hippo.upload_file_from_url(
    folder.id,
    "https://example.com/api-docs.pdf",
    "api-docs.pdf"
)

# 3. Create chat
chat = hippo.create_chat(folder.id, "Technical Support")

# 4. Ask questions
questions = [
    "How do I authenticate?",
    "What are the API rate limits?",
    "How do I handle errors?"
]

for question in questions:
    answer = hippo.submit_ask(chat.id, question)
    print(f"\nQ: {question}")
    print(f"A: {answer.response}")
    print(f"Sources: {len(answer.sources)} citations")

import asyncio
from cerevox import AsyncHippo

async def main():
    async with AsyncHippo(api_key="your-api-key") as hippo:
        # 1. Create folder
        folder = await hippo.create_folder("Product Docs")

        # 2. Upload files concurrently
        files = await asyncio.gather(
            hippo.upload_file(folder.id, "guide.pdf"),
            hippo.upload_file(folder.id, "docs.pdf")
        )

        # 3. Create chat
        chat = await hippo.create_chat(folder.id, "Support")

        # 4. Ask questions
        answer = await hippo.submit_ask(
            chat.id,
            "How do I get started?"
        )

        print(f"Answer: {answer.response}")
        print(f"Sources: {len(answer.sources)}")

# Run async workflow
asyncio.run(main())