Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Cover every public API in the Demo app

Open
#468 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 3 days

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
swift
Domain
testing

Research direction

Read the Demo app flows and compare their API calls with the public API list in this issue, starting with the Files namespace added in #401. The issue proposes one screen or flow per API group and separate pull requests; the first Files screen depends on #401. Done means the Demo exercises each public API group against the live service, with coverage for new API surface arriving alongside it.

Written by the indexing model from the issue text.

Description

The Demo app is currently the only way to exercise the package end to end against the live API: the test suite uses mocked sessions only, and CI doesn't build the Demo. Several public APIs aren't used by the Demo at all, so nothing ever runs them against the real service.

The goal is for the Demo to exercise every public API, so that a change can be checked end to end before release, and for new API surface to arrive together with its Demo coverage.

Not covered today

As of main after 0.5.3, the Demo doesn't call:

  • Embeddings: embeddings(query:)
  • Models: model(query:) (retrieving a single model; models() is used)
  • Images: imageVariations(query:)
  • Audio:
    • audioCreateSpeechStream(query:)
    • audioTranscriptions(query:), audioTranscriptionsVerbose(query:), audioTranscriptionStream(query:)
    • audioTranslations(query:)
  • Files: the openAI.files namespace from #401 (create, retrieve, list, delete, content). The Demo only uploads through the deprecated files(query:), for Assistants.
  • Batch API (#465), once it exists

The Assistants API isn't listed: it's planned to be removed from both the package and the Demo.

Approach

One Demo screen or flow per API group, each in its own pull request. The Files screen is the first, stacked on #401.

Dominant language
Swift
Stars
2.9k
Forks
519
Avg merge
4d 9h
Merged PRs (30d)
13

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from MacPaw/OpenAI

All issues in MacPaw/OpenAI

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.