{"id":22819377,"url":"https://github.com/arkaniightt/web_app_transcriptor_openai","last_synced_at":"2025-03-30T23:13:13.930Z","repository":{"id":267573292,"uuid":"901665155","full_name":"ArkaNiightt/Web_App_Transcriptor_Openai","owner":"ArkaNiightt","description":"Ferramenta de transcrição automática de áudio para texto, utilizando Streamlit e OpenAI, com suporte a microfone, vídeo e upload de arquivos de áudio.","archived":false,"fork":false,"pushed_at":"2024-12-11T05:11:14.000Z","size":29053,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T23:13:02.571Z","etag":null,"topics":["ai","app","openai","python","streamlit","tool","tools","transcript","transcription","webapp","whisper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArkaNiightt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-11T04:54:06.000Z","updated_at":"2024-12-11T05:14:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"c0c5527f-8183-4edb-929d-befdce91e2f2","html_url":"https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai","commit_stats":null,"previous_names":["arkaniightt/web_app_transcriptor_openai"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArkaNiightt%2FWeb_App_Transcriptor_Openai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArkaNiightt%2FWeb_App_Transcriptor_Openai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArkaNiightt%2FWeb_App_Transcriptor_Openai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArkaNiightt%2FWeb_App_Transcriptor_Openai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArkaNiightt","download_url":"https://codeload.github.com/ArkaNiightt/Web_App_Transcriptor_Openai/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246390872,"owners_count":20769478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","app","openai","python","streamlit","tool","tools","transcript","transcription","webapp","whisper"],"created_at":"2024-12-12T15:11:25.076Z","updated_at":"2025-03-30T23:13:13.915Z","avatar_url":"https://github.com/ArkaNiightt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"images/image_logo_project.gif\" align=\"center\" width=\"10%\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003ch1 align=\"center\"\u003eWEB_APP_TRANSCRIPTOR_OPENAI\u003c/h1\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n \u003cem\u003eTranscrevendo a Web, um Sussurro de Cada Vez!\u003c/em\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"https://img.shields.io/github/license/ArkaNiightt/Web_App_Transcriptor_Openai?style=default\u0026logo=opensourceinitiative\u0026logoColor=white\u0026color=00ff86\" alt=\"licença\"\u003e\n \u003cimg src=\"https://img.shields.io/github/last-commit/ArkaNiightt/Web_App_Transcriptor_Openai?style=default\u0026logo=git\u0026logoColor=white\u0026color=00ff86\" alt=\"último commit\"\u003e\n \u003cimg src=\"https://img.shields.io/github/languages/top/ArkaNiightt/Web_App_Transcriptor_Openai?style=default\u0026color=00ff86\" alt=\"linguagem principal do repositório\"\u003e\n \u003cimg src=\"https://img.shields.io/github/languages/count/ArkaNiightt/Web_App_Transcriptor_Openai?style=default\u0026color=00ff86\" alt=\"número de linguagens no repositório\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003c!-- opção padrão, sem badges de dependência. --\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n \u003c!-- opção padrão, sem badges de dependência. --\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n## 🔗 Índice\n\n- [📍 Visão Geral](#-visão-geral)\n- [👾 Funcionalidades](#-funcionalidades)\n- [📁 Estrutura do Projeto](#-estrutura-do-projeto)\n  - [📂 Índice do Projeto](#-índice-do-projeto)\n- [🚀 Começando](#-começando)\n  - [☑️ Pré-requisitos](#-pré-requisitos)\n  - [⚙️ Instalação](#️-instalação)\n  - [🤖 Uso](#-uso)\n  - [🧪 Testes](#-testes)\n- [📌 Roteiro do Projeto](#-roteiro-do-projeto)\n- [🔰 Contribuindo](#-contribuindo)\n- [🎗 Licença](#-licença)\n- [🙌 Agradecimentos](#-agradecimentos)\n\n---\n\n## 📍 Visão Geral\n\nO projeto WebAppTranscriptorOpenai é uma ferramenta inovadora projetada para converter linguagem falada em texto escrito. Ele utiliza o sistema Whisper ASR da OpenAI para transcrever áudio de várias fontes, incluindo microfones e arquivos de vídeo. Esta aplicação amigável, com recursos de comunicação em tempo real e tratamento de erros, é ideal para profissionais que precisam de transcrições rápidas e precisas, como jornalistas, pesquisadores e estudantes.\n\n---\n\n## 👾 Funcionalidades\n\n|      | Funcionalidade      | Resumo       |\n| :--- | :---:               | :---         |\n| ⚙️  | **Arquitetura**     | \u003cul\u003e\u003cli\u003eO projeto é estruturado em dois arquivos Python principais: `app.py` e `utils.py`.\u003c/li\u003e\u003cli\u003e`app.py` serve como ponto de entrada principal, fornecendo a interface do usuário e lidando com as interações do usuário.\u003c/li\u003e\u003cli\u003e`utils.py` gerencia operações de arquivos de áudio e vídeo, incluindo extração de áudio de arquivos de vídeo e transcrição do conteúdo de áudio usando o sistema Whisper ASR da OpenAI.\u003c/li\u003e\u003c/ul\u003e |\n| 🔩 | **Qualidade do Código** | \u003cul\u003e\u003cli\u003eO código é bem estruturado e modular, com clara separação de responsabilidades entre `app.py` e `utils.py`.\u003c/li\u003e\u003cli\u003eHá tratamento eficaz de erros e notificações de sucesso para interações do usuário.\u003c/li\u003e\u003cli\u003eO código utiliza recursos modernos do Python e bibliotecas, como Streamlit para a interface do usuário e OpenAI para o serviço de transcrição.\u003c/li\u003e\u003c/ul\u003e |\n| 📄 | **Documentação**     | \u003cul\u003e\u003cli\u003eA linguagem principal usada no projeto é Python, com um total de 2 arquivos Python e 2 arquivos de texto.\u003c/li\u003e\u003cli\u003eO projeto usa `pip` como gerenciador de pacotes, com dependências especificadas em `requirements.txt`.\u003c/li\u003e\u003cli\u003eInstruções de instalação e uso são fornecidas, incluindo comandos para instalar dependências e executar a aplicação.\u003c/li\u003e\u003c/ul\u003e |\n| 🔌 | **Integrações**      | \u003cul\u003e\u003cli\u003eO projeto integra-se com o sistema Whisper ASR da OpenAI para serviços de transcrição.\u003c/li\u003e\u003cli\u003eUtiliza a biblioteca Streamlit para a interface do usuário e WebRTC para comunicação em tempo real.\u003c/li\u003e\u003cli\u003eO projeto também integra o framework multimídia `ffmpeg` para manusear vídeo, áudio e outros arquivos e fluxos multimídia.\u003c/li\u003e\u003c/ul\u003e |\n| 🧩 | **Modularidade**     | \u003cul\u003e\u003cli\u003eO projeto é modular, com módulos Python separados para diferentes funcionalidades (`app.py` e `utils.py`).\u003c/li\u003e\u003cli\u003eCada módulo tem um papel específico, tornando o código fácil de entender e manter.\u003c/li\u003e\u003c/ul\u003e |\n| 🧪 | **Testes**           | \u003cul\u003e\u003cli\u003eEmbora não haja arquivos de teste explícitos no projeto, as instruções de uso incluem um comando para executar testes com `pytest`.\u003c/li\u003e\u003cli\u003eIsso sugere que o projeto pode ter um framework de testes configurado, embora os detalhes não sejam especificados no contexto fornecido.\u003c/li\u003e\u003c/ul\u003e |\n| ⚡️  | **Desempenho**      | \u003cul\u003e\u003cli\u003eO projeto utiliza bibliotecas eficientes como `numpy` e `pandas` para manipulação de dados, conhecidas por seu desempenho.\u003c/li\u003e\u003cli\u003eO uso do sistema Whisper ASR da OpenAI para transcrição provavelmente garante alta precisão e velocidade.\u003c/li\u003e\u003c/ul\u003e |\n| 🛡️ | **Segurança**       | \u003cul\u003e\u003cli\u003eO projeto estabelece uma conexão segura com o cliente OpenAI usando uma chave de API.\u003c/li\u003e\u003cli\u003eNo entanto, sem mais informações, é difícil avaliar completamente as medidas de segurança do projeto.\u003c/li\u003e\u003c/ul\u003e |\n\n---\n\n## 📁 Estrutura do Projeto\n\n```sh\n└── Web_App_Transcriptor_Openai/\n    ├── app.py\n    ├── ffmpeg.exe\n    ├── packages.txt\n    ├── requirements.txt\n    └── utils.py\n```\n\n### 📂 Índice do Projeto\n\n\u003cdetails open\u003e\n \u003csummary\u003e\u003cb\u003e\u003ccode\u003eWEB_APP_TRANSCRIPTOR_OPENAI/\u003c/code\u003e\u003c/b\u003e\u003c/summary\u003e\n \u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003e__root__\u003c/b\u003e\u003c/summary\u003e\n  \u003cblockquote\u003e\n   \u003ctable\u003e\n   \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003e\u003ca href='https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai/blob/master/utils.py'\u003eutils.py\u003c/a\u003e\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e- O módulo 'utils.py' no projeto gerencia principalmente operações de arquivos de áudio e vídeo\u003cbr\u003e- Extrai áudio de arquivos de vídeo, salva-os temporariamente e transcreve o conteúdo de áudio usando o sistema Whisper ASR da OpenAI\u003cbr\u003e- Este módulo também estabelece uma conexão com o cliente OpenAI usando uma chave de API, garantindo integração perfeita com os serviços da OpenAI.\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003e\u003ca href='https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai/blob/master/app.py'\u003eapp.py\u003c/a\u003e\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e- O 'app.py' serve como o ponto de entrada principal para a ferramenta de transcrição de áudio\u003cbr\u003e- Fornece três métodos de transcrição: via microfone, vídeo ou arquivo de áudio\u003cbr\u003e- A ferramenta usa a biblioteca Streamlit para a interface do usuário, WebRTC para comunicação em tempo real e OpenAI para o serviço de transcrição\u003cbr\u003e- Também inclui tratamento de erros e notificações de sucesso para interações do usuário.\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003e\u003ca href='https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai/blob/master/requirements.txt'\u003erequirements.txt\u003c/a\u003e\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e- O arquivo 'requirements.txt' especifica os pacotes Python necessários para o projeto\u003cbr\u003e- Garante ambientes consistentes em diferentes configurações, auxiliando na reprodutibilidade do projeto\u003cbr\u003e- Os pacotes listados variam de manipulação de dados (pandas, numpy), frameworks web (streamlit), a bibliotecas de machine learning (openai), indicando um escopo de aplicação diversificado.\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003e\u003ca href='https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai/blob/master/packages.txt'\u003epackages.txt\u003c/a\u003e\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e- O 'packages.txt' serve como um manifesto para o projeto, especificando as dependências externas necessárias para o software funcionar corretamente\u003cbr\u003e- Neste caso, indica a necessidade do pacote ffmpeg, um poderoso framework multimídia usado para manipular vídeo, áudio e outros arquivos e fluxos multimídia dentro do código do projeto.\u003c/td\u003e\n   \u003c/tr\u003e\n   \u003c/table\u003e\n  \u003c/blockquote\u003e\n \u003c/details\u003e\n\u003c/details\u003e\n\n---\n\n## 🚀 Começando\n\n### ☑️ Pré-requisitos\n\nAntes de começar com o Web_App_Transcriptor_Openai, certifique-se de que seu ambiente de execução atenda aos seguintes requisitos:\n\n- **Linguagem de Programação:** Python\n- **Gerenciador de Pacotes:** Pip\n\n### ⚙️ Instalação\n\nInstale o Web_App_Transcriptor_Openai usando um dos seguintes métodos:\n\n**Compilação a partir do código-fonte:**\n\n1. Clone o repositório Web_App_Transcriptor_Openai:\n\n```sh\n❯ git clone https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai\n```\n\n2. Navegue até o diretório do projeto:\n\n```sh\n❯ cd Web_App_Transcriptor_Openai\n```\n\n3. Instale as dependências do projeto:\n\n**Usando `pip`** \u0026nbsp; [\u003cimg align=\"center\" src=\"https://img.shields.io/badge/Pip-3776AB.svg?style={badge_style}\u0026logo=pypi\u0026logoColor=white\" /\u003e](https://pypi.org/project/pip/)\n\n```sh\n❯ pip install -r requirements.txt\n```\n\n### 🤖 Uso\n\nExecute o Web_App_Transcriptor_Openai usando o seguinte comando:\n**Usando `pip`** \u0026nbsp; [\u003cimg align=\"center\" src=\"https://img.shields.io/badge/Pip-3776AB.svg?style={badge_style}\u0026logo=pypi\u0026logoColor=white\" /\u003e](https://pypi.org/project/pip/)\n\n```sh\n❯ python {ponto_de_entrada}\n```\n\n### 🧪 Testes\n\nExecute o conjunto de testes usando o seguinte comando:\n**Usando `pip`** \u0026nbsp; [\u003cimg align=\"center\" src=\"https://img.shields.io/badge/Pip-3776AB.svg?style={badge_style}\u0026logo=pypi\u0026logoColor=white\" /\u003e](https://pypi.org/project/pip/)\n\n```sh\n❯ pytest\n```\n\n---\n\n## 📌 Roteiro do Projeto\n\n- [X] **`Tarefa 1`**: \u003cstrike\u003eImplementar a funcionalidade um.\u003c/strike\u003e\n- [ ] **`Tarefa 2`**: Implementar a funcionalidade dois.\n- [ ] **`Tarefa 3`**: Implementar a funcionalidade três.\n\n---\n\n## 🔰 Contribuindo\n\n- **💬 [Participe das Discussões](https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai/discussions)**: Compartilhe seus insights, forneça feedback ou faça perguntas.\n- **🐛 [Reporte Problemas](https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai/issues)**: Envie bugs encontrados ou registre solicitações de recursos para o projeto `Web_App_Transcriptor_Openai`.\n- **💡 [Envie Pull Requests](https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai/blob/main/CONTRIBUTING.md)**: Revise PRs abertos e envie seus próprios PRs.\n\n\u003cdetails closed\u003e\n\u003csummary\u003eDiretrizes de Contribuição\u003c/summary\u003e\n\n1. **Faça um Fork do Repositório**: Comece fazendo um fork do repositório do projeto para sua conta do GitHub.\n2. **Clone Localmente**: Clone o repositório forkado para sua máquina local usando um cliente git.\n\n   ```sh\n   git clone https://github.com/ArkaNiightt/Web_App_Transcriptor_Openai\n   ```\n\n3. **Crie um Novo Branch**: Sempre trabalhe em um novo branch, dando-lhe um nome descritivo.\n\n   ```sh\n   git checkout -b nova-funcionalidade-x\n   ```\n\n4. **Faça Suas Alterações**: Desenvolva e teste suas alterações localmente.\n5. **Commite Suas Alterações**: Faça commit com uma mensagem clara descrevendo suas atualizações.\n\n   ```sh\n   git commit -m 'Implementada nova funcionalidade x.'\n   ```\n\n6. **Envie para o GitHub**: Envie as alterações para o seu repositório forkado.\n\n   ```sh\n   git push origin nova-funcionalidade-x\n   ```\n\n7. **Envie um Pull Request**: Crie um PR contra o repositório original do projeto. Descreva claramente as alterações e suas motivações.\n8. **Revisão**: Uma vez que seu PR for revisado e aprovado, ele será mesclado ao branch principal. Parabéns pela sua contribuição!\n\n\u003c/details\u003e\n\n\u003cdetails open\u003e\n\u003csummary\u003eGráfico de Contribuidores\u003c/summary\u003e\n\u003cbr\u003e\n\u003cp align=\"left\"\u003e\n   \u003ca href=\"https://github.com{/ArkaNiightt/Web_App_Transcriptor_Openai/}graphs/contributors\"\u003e\n      \u003cimg src=\"https://contrib.rocks/image?repo=ArkaNiightt/Web_App_Transcriptor_Openai\"\u003e\n   \u003c/a\u003e\n\u003c/p\u003e\n\u003c/details\u003e\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farkaniightt%2Fweb_app_transcriptor_openai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farkaniightt%2Fweb_app_transcriptor_openai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farkaniightt%2Fweb_app_transcriptor_openai/lists"}