{"id":46435019,"url":"https://github.com/6ixgodd/audex","last_synced_at":"2026-04-22T13:01:29.463Z","repository":{"id":325796140,"uuid":"1098872268","full_name":"6ixGODD/audex","owner":"6ixGODD","description":"Smart Medical Recording \u0026 Transcription System with voice recognition and speaker identification.","archived":false,"fork":false,"pushed_at":"2026-04-18T03:13:42.000Z","size":1158,"stargazers_count":4,"open_issues_count":5,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-18T05:27:57.339Z","etag":null,"topics":["asr","nicegui","pywebview","transcription","voiceprint-recognition"],"latest_commit_sha":null,"homepage":"https://6ixgodd.github.io/audex/","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/6ixGODD.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-18T08:56:13.000Z","updated_at":"2026-04-18T03:13:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/6ixGODD/audex","commit_stats":null,"previous_names":["6ixgodd/audex"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/6ixGODD/audex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/6ixGODD%2Faudex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/6ixGODD%2Faudex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/6ixGODD%2Faudex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/6ixGODD%2Faudex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/6ixGODD","download_url":"https://codeload.github.com/6ixGODD/audex/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/6ixGODD%2Faudex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32137365,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T08:34:57.708Z","status":"ssl_error","status_checked_at":"2026-04-22T08:34:55.583Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["asr","nicegui","pywebview","transcription","voiceprint-recognition"],"created_at":"2026-03-05T20:03:30.866Z","updated_at":"2026-04-22T13:01:29.448Z","avatar_url":"https://github.com/6ixGODD.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n![Audex Logo](docs/assets/logo.svg)\n\n# Audex\n\n[![PyPI version](https://badge.fury.io/py/audex.svg)](https://pypi.org/project/audex/)\n[![Python](https://img.shields.io/pypi/pyversions/audex.svg)](https://pypi.org/project/audex/)\n[![License](https://img.shields.io/github/license/6ixGODD/audex.svg)](https://github.com/6ixGODD/audex/blob/main/LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/6ixGODD/audex.svg)](https://github.com/6ixGODD/audex/stargazers)\n\nDerived from \"Audio Exchange\", Smart Medical Recording \u0026 Transcription System with voice recognition and speaker identification.\n\n[Documentation](https://6ixgodd.github.io/audex/) • [Installation Guide](https://6ixgodd.github.io/audex/installation/) • [API Reference](https://6ixgodd.github.io/audex/reference/)\n\nEnglish | [简体中文](README.zh-CN.md)\n\n\u003c/div\u003e\n\n---\n\n## System Requirements\n\n- Python 3.10-3.13\n- uv (package manager)\n- PortAudio\n- FFmpeg\n- SQLite3\n- PyQt6 (Linux: install from system packages)\n- NetworkManager (Linux: for WiFi connectivity)\n\n### System Dependencies\n\n**Ubuntu/Debian:**\n```bash\nsudo apt-get install python3-pyqt6 python3-pyqt6.qtwebengine \\\n    portaudio19-dev ffmpeg sqlite3 network-manager \\\n    libfcitx5-qt6-1 alsa-utils gcc build-essential\n```\n\n**macOS:**\n```bash\nbrew install portaudio ffmpeg sqlite3\npip install PyQt6 PyQt6-WebEngine\n```\n\n**Windows:**\n- PortAudio is bundled with PyAudio wheel\n- FFmpeg: Download from https://ffmpeg.org/download.html and add to `PATH`\n- SQLite3: Included with Python installation\n\n---\n\n## Installation\n\n### From PyPI\n\n```bash\npip install audex\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/6ixGODD/audex.git\ncd audex\nuv sync\n```\n\n### DEB Package (Debian/Ubuntu/Raspberry Pi)\n\nDownload the appropriate DEB package for your architecture from [Releases](https://github.com/6ixGODD/audex/releases).\n\nFor detailed installation instructions, see [Installation Guide](https://6ixgodd.github.io/audex/installation/).\n\n**Quick Install:**\n\n```bash\n# Download and install\nsudo dpkg -i audex_{version}_arm64.deb\nsudo apt-get install -f\n\n# Run configuration wizard\nsudo audex-setup\n\n# Start application\nsudo audex\n```\n\n---\n\n## Usage\n\n### Run Application\n\n```bash\n# Start with config file\naudex -c config.yaml\n\n# Using installed package\npython -m audex -c config.yaml\n```\n\n### Initialize Configuration\n\n```bash\n# Generate default configuration\naudex init gencfg --format yaml --output config.yaml\n\n# Generate system configuration (Linux)\naudex init gencfg --format system --output /etc/audex/config.yml --platform linux\n```\n\n### Initialize VPR Group\n\n```bash\n# Initialize voice print recognition group\naudex init vprgroup --config config.yaml\n```\n\n### File Export Server\n\n```bash\n# Start file export server\naudex serve --config config.yaml\n```\n\n---\n\n## Configuration\n\nConfiguration file structure:\n\n```yaml\ncore:\n  app:\n    app_name: Audex\n    native: true\n  logging:\n    targets:\n      - logname: stdout\n        loglevel: info\n  audio:\n    sample_rate: 16000\n\nprovider:\n  transcription:\n    provider: dashscope\n    dashscope:\n      credential:\n        api_key: \u003cYOUR_API_KEY\u003e\n\n  vpr:\n    provider: xfyun\n    xfyun:\n      credential:\n        app_id: \u003cYOUR_APP_ID\u003e\n        api_key: \u003cYOUR_API_KEY\u003e\n        api_secret: \u003cYOUR_API_SECRET\u003e\n\ninfrastructure:\n  sqlite:\n    uri: \"sqlite+aiosqlite:///path/to/audex.db\"\n  store:\n    type: localfile\n    base_url: /path/to/store\n```\n\nSee `config.example.yml` for complete configuration options.\n\n---\n\n## Development\n\n### Install Development Dependencies\n\n```bash\n# Development environment\nuv sync --extra dev\n\n# Testing environment\nuv sync --extra test\n\n# Documentation environment\nuv sync --extra docs\n```\n\n### Build Package\n\n```bash\n# Build wheel and sdist\nuv build\n\n# Output: dist/audex-{version}-py3-none-any.whl\n```\n\n### Run Tests\n\n```bash\nuv sync --extra test\nuv run pytest\n```\n\n### Documentation\n\n```bash\nuv sync --extra docs\nuv run mkdocs serve\n\n# Visit: http://127.0.0.1:8000\n```\n\n---\n\n## DEB Package Development\n\n### Build DEB Package\n\n**Prerequisites:**\n- Docker\n\n**Build:**\n\n```bash\ncd packaging/linux\n\n# Build for ARM64 (Raspberry Pi)\n./build.sh\n\n# Build for AMD64\n./build.sh amd64\n```\n\n**Output:** `dist/audex_{version}_{arch}.deb`\n\n### Test DEB Package\n\n```bash\ncd packaging/linux\n./test.sh arm64\n```\n\n**Inside test container:**\n\n```bash\n# Install package\ndpkg -i /tmp/audex.deb\napt-get install -f\n\n# Verify installation\nwhich audex\naudex --version\n\n# View configurations\ncat /etc/audex/config.system.yml\ncat /etc/audex/config.example.yml\n\n# Run configuration wizard\naudex-setup\n\n# Exit container\nexit\n```\n\n---\n\n## Project Structure\n\n```\naudex/\n├── audex/                 # Main package\n│   ├── cli/               # Command-line interface\n│   ├── service/           # Business layer\n│   ├── entity/            # Entities\n│   ├── filters/           # Data filters\n│   ├── valueobj/          # Value objects\n│   ├── view/              # View layer\n│   └── lib/               # Shared libraries\n├── packaging/\n│   └── linux/             # DEB packaging\n│       ├── templates/     # Package templates\n│       ├── build.sh       # Build script\n│       └── test.sh        # Test script\n├── scripts/               # Development scripts\n├── tests/                 # Test suite\n└── pyproject.toml         # Project configuration\n```\n\n---\n\n## Links\n\n- **Documentation**: https://6ixgodd.github.io/audex/\n- **PyPI**: https://pypi.org/project/audex/\n- **GitHub**: https://github.com/6ixGODD/audex\n- **Issues**: https://github.com/6ixGODD/audex/issues\n- **Releases**: https://github.com/6ixGODD/audex/releases\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F6ixgodd%2Faudex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F6ixgodd%2Faudex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F6ixgodd%2Faudex/lists"}