aeneas logo

aeneas

readbeyond/aeneas

Python library and tools for audio-text synchronization

GraphCanon updated 3w · GitHub synced 3w

2.9k stars274 forksLast push 1mo Python AGPL-3.0

Decision brief

Aeneas is a Python library and CLI toolset for audio-text synchronization specifically designed to address forced alignment needs.

Good fit when

  • When you need precise alignment of text with spoken words in audio files, as Aeneas excels at forced alignment tasks
  • If your project requires integration into existing Python workflows that demand high performance and accuracy

Avoid when

  • Avoid if your system cannot meet the minimum requirements for Python versions below 3.5 or lacks essential dependencies such as FFmpeg or eSpeak
  • Do not use when a more lightweight solution suffices, as Aeneas includes comprehensive but resource-intensive C/C++ extensions
Requirements:
Min 4 GB RAM; Python 2.7 or later; FFmpeg; eSpeak; Numpy, BeautifulSoup4, lxml as Python packages

Observed Jul 17, 2026 · Source: enrich:decision_facts

Verify the decision

Maintenance and security

Full trust report
Maintenance
Very active (4d since push)
As of 3w
Provenance
Not a fork · Personal account
As of 3w
Security (OSV)
24 low (24 low)
As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

pip install aeneas
PyPI

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

Aeneas is a Python/C library and set of command-line tools designed to align text with corresponding spoken words in audio files, crucial for forced alignment applications.

Capability facts

Languages
python

Source: github.language · Jul 29, 2026

Categories

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Python runtimePython

Source: README excerpt (regex_v1, Jul 29, 2026)

2. [Python](https://python.org/) 2.7 (Linux, OS X, Windows) or 3.5 or later (Linux, OS X)
Source link

Tags

README

System Requirements, Supported Platforms and Installation


System Requirements

  1. a reasonably recent machine (recommended 4 GB RAM, 2 GHz 64bit CPU)
  2. Python 2.7 (Linux, OS X, Windows) or 3.5 or later (Linux, OS X)
  3. FFmpeg
  4. eSpeak
  5. Python packages BeautifulSoup4, lxml, and numpy
  6. Python headers to compile the Python C/C++ extensions (optional but strongly recommended)
  7. A shell supporting UTF-8 (optional but strongly recommended)

Installation

All-in-one installers are available for Mac OS X and Windows, and a Bash script for deb-based Linux distributions (Debian, Ubuntu) is provided in this repository. It is also possible to download a VirtualBox+Vagrant virtual machine. Please see the INSTALL file for detailed, step-by-step installation procedures for different operating systems.

The generic OS-independent procedure is simple:

  1. Install Python (2.7.x preferred), FFmpeg, and eSpeak

  2. Make sure the following executables can be called from your shell: espeak, ffmpeg, ffprobe, pip, and python

  3. First install numpy with pip and then aeneas (this order is important):

    pip install numpy
    pip install aeneas
    
  4. To check whether you installed aeneas correctly, run:

     python -m aeneas.diagnostics
    

License

aeneas is released under the terms of the GNU Affero General Public License Version 3. See the LICENSE file for details.

Licenses for third party code and files included in aeneas can be found in the licenses directory.

No copy rights were harmed in the making of this project.

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.