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.31.tar.gz (15.3 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.31-py3-none-any.whl (13.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for easier_openai-0.2.31.tar.gz
Algorithm Hash digest
SHA256 970016bf4b8766c862587bd3f9559d49a4685a59edf78ebbf69d00fc833fad00
MD5 196aaa5018d3a87d6bbdbac765d70eaa
BLAKE2b-256 73c0503f76edb1db8d3da8bdf067fc0c22dc5bb55dd9d89e1c57c6e2a2f3d932

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for easier_openai-0.2.31-py3-none-any.whl
Algorithm Hash digest
SHA256 efca483453e10ad6fea95783c62839d5296154bc36209a0e75cc555b3ac25b09
MD5 38985e9614deebc45055f544a4248fc0
BLAKE2b-256 3697f3632fdb291ca6c5593c0bc2ad64560d197f1ed5fecd6cf9a4c4e24cd25d

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