{"id":23365,"library":"bithuman","title":"Bithuman","description":"Real-time avatar engine (v1.10.8) generating lip-synced video and streaming live avatars to browsers at 100+ FPS on CPU. Requires Python >=3.9, supports ARM/x86/macOS. Active development with regular releases.","status":"active","version":"1.10.8","language":"python","source_language":"en","source_url":"https://github.com/bithuman-product/bithuman-python-sdk","tags":["avatar","lip-sync","real-time","video-generation","ai"],"install":[{"cmd":"pip install bithuman","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Core dependency for numerical operations","package":"numpy","optional":false},{"reason":"Video processing and display","package":"opencv-python","optional":false},{"reason":"API calls","package":"requests","optional":false}],"imports":[{"note":"Old SDK used 'Client'; renamed in v1.5","wrong":"from bithuman import Client","symbol":"BithumanClient","correct":"from bithuman import BithumanClient"},{"note":"Config moved to top-level in v1.6","wrong":"from bithuman.config import AvatarConfig","symbol":"AvatarConfig","correct":"from bithuman import AvatarConfig"}],"quickstart":{"code":"from bithuman import BithumanClient, AvatarConfig\nimport os\n\nclient = BithumanClient(api_key=os.environ.get('BITHUMAN_API_KEY', ''))\nconfig = AvatarConfig(avatar_id='default', language='en')\nresult = client.generate_video(text='Hello, world!', config=config)\nprint(result.video_url)","lang":"python","description":"Initialize client and generate a lip-synced video from text."},"warnings":[{"fix":"Update import: from bithuman import BithumanClient","message":"v1.5: 'Client' class renamed to 'BithumanClient'. Breakage if using old name.","severity":"breaking","affected_versions":"<1.5"},{"fix":"Use: from bithuman import AvatarConfig","message":"v1.6: 'AvatarConfig' was moved from bithuman.config to bithuman. Old import deprecated.","severity":"deprecated","affected_versions":">=1.6"},{"fix":"Always create an AvatarConfig object and pass it as config=config","message":"The 'generate_video' method requires a 'config' argument; passing just text fails silently with AttributeError.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run: pip install bithuman","cause":"Package not installed or virtual environment not activated.","error":"ModuleNotFoundError: No module named 'bithuman'"},{"fix":"Use: from bithuman import BithumanClient","cause":"Using old class name 'Client' which was renamed in v1.5.","error":"AttributeError: module 'bithuman' has no attribute 'Client'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}