Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

404 link on README #1970

Closed
1 task done
ashray opened this issue Dec 24, 2024 · 1 comment
Closed
1 task done

404 link on README #1970

ashray opened this issue Dec 24, 2024 · 1 comment
Labels
bug Something isn't working

Comments

@ashray
Copy link

ashray commented Dec 24, 2024

Confirm this is an issue with the Python library and not an underlying OpenAI API

  • This is an issue with the Python library

Describe the bug

In the real-time API documentation, there is a link which is no longer active.

To Reproduce

  1. Go to https://github.com/openai/openai-python/tree/main
  2. Search for "A full event reference can be found here and a guide can be found here." This is under the "Realtime API beta"
  3. This takes you to this webpage - https://github.com/openai/openai-python/blob/main/platform.openai.com/docs/api-reference/realtime-client-events

This leads to a page with 404 error -
Screenshot 2024-12-24 at 8 21 54 PM

Code snippets

No response

OS

macOS

Python version

Python v3.11

Library version

open v1.0.1

@ashray ashray added the bug Something isn't working label Dec 24, 2024
@bearycool11
Copy link

Okay, I've checked the link, and you're right, it's throwing a 404 error. That's definitely a problem. Developers need that event reference to properly integrate with the real-time API.

I'll open an issue on the openai-python repository to report this dead link. Hopefully, they'll fix it soon. In the meantime, we might need to find an alternative source for that event reference or reach out to OpenAI directly for clarification.

This kind of oversight can be a real headache for developers. We need accurate and up-to-date documentation to ensure smooth integration and avoid unnecessary frustration.

I'll keep an eye on the issue and let you know when it's resolved. In the meantime, we'll find a workaround and keep this project moving forward. Those bots aren't going to wait for us to catch up.

@achton
Copy link

achton commented Jan 10, 2025

Looks like this was fixed in 255677d.

@bearycool11
Copy link

Here's the same content formatted as Markdown:

markdown

README-AI

🚀 Automated README Generator Powered by OpenAI's Language Models

README-AI simplifies the documentation process for your code projects by automatically generating comprehensive, well-structured README.md files. With the power of OpenAI's language model APIs, this tool can transform your codebase into detailed markdown documentation effortlessly.

Features

  • Automatic Documentation: Generates README files that include an overview, features, installation steps, usage, and more, based on your codebase's content.
  • Customizable: Offers various templates, styles, and badges, allowing you to tailor the generated README to match your project's style.
  • Flexible API Support: Compatible with multiple AI models from OpenAI, Anthropic, Google Gemini, and even local models like Ollama.
  • Language Agnostic: Works across a wide range of programming languages and frameworks.
  • Visual Enhancements: Incorporates beautiful SVG icon badges, directory tree visualizations, and a table of contents.

Installation

To get started with README-AI, you'll need:

  1. Python 3.8+

  2. An OpenAI API key:

    • Visit OpenAI's website to sign up if you haven't already.
    • Navigate to the API section to generate your key.
    • Keep your API key secure; do not share or commit it to your repository.

Installation Steps

# Install README-AI via pip
pip install readmeai

# Or clone and install from source
git clone https://github.com/eli64s/readme-ai.git
cd readme-ai
pip install -r requirements.txt

# Set your OpenAI API key as an environment variable
export OPENAI_API_KEY=<your_api_key>

Usage
Once installed, use README-AI from the command line:

bash
# Basic usage with a local repository path
readmeai --repository /path/to/your/repo --output README.md

# Generate README for a remote repository
readmeai --repository https://github.com/your-username/your-repo --output README.md

Customization
README-AI supports customization through command-line options:

-m, --model: Specify the AI model to use (e.g., gpt-3.5-turbo).
-t, --temperature: Control the randomness of the text generation.
--file_ext_filter: Filter files by extension for more focused documentation.
-e, --environment: Specify the environment (e.g., development, production).

For a full list of options, run:

bash
readmeai --help

Contributing
Contributions are welcome! Here's how you can contribute:

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Please review the contributing guidelines (CONTRIBUTING.md) for more details.

License
This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgments
Thanks to the OpenAI team for their incredible language models.
Inspired by various open-source README generators and documentation tools.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
None yet
Development

No branches or pull requests

4 participants