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.52.tar.gz (15.5 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.52-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for easier_openai-0.2.52.tar.gz
Algorithm Hash digest
SHA256 0cd65d8b1d918cc37253f1f01ef9412073fe54e47b77df5221c2a67c2225c6c8
MD5 fd26ab017e8b79390bc507b508393040
BLAKE2b-256 c2ce3ee0d696fc3e10707003124892119df88b928c80f8ba4a8a53f9d2633012

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for easier_openai-0.2.52-py3-none-any.whl
Algorithm Hash digest
SHA256 305161e43bb677302c619678b10f0cbb553724a37425b4322ecf1969d89f1762
MD5 34bba71053d0157336b7f201e856451b
BLAKE2b-256 157ebbf91c422b8f89b4ece92ccd217918442907d5fa7092b1d1dec671811ec8

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