Skip to main content

Utilities for orchestrating OpenAI chat, tool calling, search, audio, and images from one helper package.

Project description

Easier OpenAI

Easier OpenAI offers a light wrapper around the OpenAI Python SDK so you can chat with models, toggle built-in tools, upload reference files, and request images through one unified helper.

Highlights

  • Single Assistant class for conversational flows, tool selection, and multi-turn context.
  • Temporary vector store support to search across local reference documents during a chat.
  • Flags for web search or code interpreter when the selected OpenAI model supports them.
  • Image helpers for gpt-image-1, dall-e-2, and dall-e-3 with convenient file handling.

Installation

pip install easier-openai

Set OPENAI_API_KEY in your environment or pass an explicit key when you build the assistant instance.

Usage Example

from easier_openai import Assistant

assistant = Assistant(model="gpt-4o", system_prompt="You are concise.")
response_text = assistant.chat("Summarize Rayleigh scattering in one sentence.")
print(response_text)

File Search Example

notes = ["notes/overview.md", "notes/data-sheet.pdf"]
reply = assistant.chat(
    "Highlight key risks from the attached docs",
    file_search=notes,
    tools_required="auto",
)
print(reply)

Requirements

  • Python 3.10 or newer
  • openai>=1.43.0
  • typing_extensions>=4.7.0
  • pydantic>=2.0.0

Contributing

Issues and pull requests are welcome. Please run checks locally before submitting changes.

License

This project is licensed under the Apache License 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

easier_openai-0.2.4.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

easier_openai-0.2.4-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

Details for the file easier_openai-0.2.4.tar.gz.

File metadata

  • Download URL: easier_openai-0.2.4.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.22

File hashes

Hashes for easier_openai-0.2.4.tar.gz
Algorithm Hash digest
SHA256 3d6d9af8fc8e569023bfbcfce8c36486b6dadb48b4bd43cb37b51acf51c28894
MD5 5b62084e02c47570667e45c4f4a75876
BLAKE2b-256 d292b11273201fa06a1af453001cc02dd75083cda61a7a5fb019a508c5e7a3d2

See more details on using hashes here.

File details

Details for the file easier_openai-0.2.4-py3-none-any.whl.

File metadata

File hashes

Hashes for easier_openai-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 562d7e1e873e7219d2a0433d2b4c82a42809d657d244698dd6c70a176b7f4df1
MD5 1b34fcac04279df24120b9739cca19e1
BLAKE2b-256 24da877d9af5e7e73504a08ab3e57083a8b8819d59456414d9a4a970eccbfc8e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page