Merge pull request 'Add uvx usage instructions and package configuration' (#1) from chore/documentation_uvx into main

Reviewed-on: #1
This commit was merged in pull request #1.
This commit is contained in:
2026-06-07 15:59:36 +00:00
2 changed files with 29 additions and 2 deletions

View File

@@ -48,10 +48,31 @@ Download and use the Llama3 model:
```bash
ollama pull llama3
## Test the access:
# Test the access:
ollama run llama3 "tell me a joke"
```
## Usage with uvx (no installation required)
You can run this tool directly without cloning the repository using `uvx`:
```bash
# Summarize a YouTube video
uvx --from git+https://github.com/damienarnodo/audio-summary-with-local-LLM.git audio-summary --from-youtube <YouTube-Video-URL>
# Summarize a local audio file
uvx --from git+https://github.com/damienarnodo/audio-summary-with-local-LLM.git audio-summary --from-local <path-to-audio-file>
# Transcribe only (no summary)
uvx --from git+https://github.com/damienarnodo/audio-summary-with-local-LLM.git audio-summary --from-youtube <YouTube-Video-URL> --transcript-only
# Specify language and output file
uvx --from git+https://github.com/damienarnodo/audio-summary-with-local-LLM.git audio-summary --from-local <path-to-audio-file> --language fr --output my_summary.md
```
> [!NOTE]
> `uvx` automatically creates a temporary virtual environment and installs all dependencies. On first run, this may take a moment. Ensure `ffmpeg` and [Ollama](https://ollama.com) are installed and running on your system.
## Usage
The tool can be executed with the following command line options:

View File

@@ -18,8 +18,14 @@ dependencies = [
"transformers>=4.50.2",
"yt-dlp>=2025.3.27",
]
[project.scripts]
audio-summary = "summary:main"
[tool.setuptools]
py-modules = []
py-modules = ["summary"]
[tool.setuptools.package-dir]
"" = "src"
[tool.ruff]
# Exclude a variety of commonly ignored directories.