BasedHardware
Backend upgrade: Stability & Firestore, Pinecone, Silero VAD & Docs
🚀 Backend Bootstrap Fixes & Improvements
This PR includes multiple fixes for backend initialization and configuration.
Each fix is in a separate commit for easier review.
🔧 Fixes & Enhancements
-
Fix Firestore client initialization with explicit project ID
4b30d81 -
Improve Pinecone vector database initialization with proper configuration handling
763c7bc -
Add project ID handling for Google Cloud Storage client initialization
cbe4a95 -
Enhance GitHub API token handling and update documentation
715e091 -
Improve Silero VAD model loading with error handling and fallback
dd659bc -
docs: Add troubleshooting section for Opus library issues
b8a5a3b -
feat: Add Typesense mock client for development & improve configuration handling
5cdbd46
📖 Documentation Updates
-
docs: Enhance Typesense configuration guide in README
dc0ee8c
🎤 Audio Processing Improvements
-
feat: Fix Silero VAD model download & loading mechanism
34650a8 -
fix: Update Silero VAD model download URL & simplify file retrieval
3ab94bd -
feat: Add PyOgg error handling & fallback mechanism for Opus codec
ffd5e69
🐳 Docker Setup Now Works Out of the Box!
🚀 How to Run
Local
uvicorn main:app --reload --env-file .env
Docker
docker compose up -d
Hooray! I did it! 🎉 Finally, it’s up and running! 🙌
Hope this helps many others!
@mdmohsin7 @thinhx I’d really appreciate a quick review. It has passed all the tests and checks. I managed to overcome 20+ errors, and it’s at least running for now. However, this is my first launch, so please take a look. Thanks! 🙏
lgtm, starts without issues, but ran into a windows-specific problem. needs further review from someone else.
lgtm, starts without issues, but ran into a windows-specific problem. needs further review from someone else.
I didn’t test it on Windows, to be honest—only on Mac. I just added the obvious path from the manuals, just in case. Better this than nothing!
Hooray! Docker and Docker Compose are now working! Added files and the dock! Enjoy! 😉
TL;DR: • Silero VAD: Fixed broken distribution, updated download link, specified versions, and added error handling for model loading. • Docker: Corrected invalid paths. • Typesense: Added mock client to enable running without a configured service. • Logging & Error Handling: Implemented logs and error reporting for all services (Firestore, GCS, Silero VAD, PyOgg); the system now reports issues clearly instead of failing silently.
guys, feel free to discuss this one btw my tips are: 1/ run the back-end yourself with the current configs and requirements successfully. 2/ simplify setup steps by separating the required envs(should be minimal) and the optional vars. then make the optional vars truly optional, meaning if developers don't add theses optional vars, the back-end should still run and core features work well. 3/ automate back-end setup with docker(or any containerization) and scripting 4/ update the document regarding the changes.
keep the PR minimal and focused on single responsibility.
getting this repo up and running is not that hard, but if it took too long for you, dm me discord / @thinh
@skywinder @mdmohsin7
ping me after 2 weeks (or when you are ready for changes)
/ draft
@skywinder
hey man, it's cleaning time.
/ closed
3 days with no updates feel free to reopen it anytime