Commit graph

42 commits

Author SHA1 Message Date
LUIS NOVO
80c9b7d3ff docs: local tts setup guide 2025-10-19 12:06:29 -03:00
Luis Novo
b5666c4d68
Fix/increase fix: increase API client timeouts for transformation operations timeouts (#170)
* fix: increase API client timeouts for transformation operations

- Increase frontend timeout from 30s to 300s (5 minutes)
- Increase Streamlit API client timeout from 30s to 300s
- Add API_CLIENT_TIMEOUT environment variable for configurability
- Add ESPERANTO_LLM_TIMEOUT environment variable documentation
- Update .env.example with comprehensive timeout documentation

Fixes #131 - API timeout errors during transformation generation
Transformations now have sufficient time to complete on slower
hardware (Ollama, LM Studio) without frontend timeout errors.

Users can now configure timeouts for both the API client layer
(API_CLIENT_TIMEOUT) and the LLM provider layer (ESPERANTO_LLM_TIMEOUT)
to accommodate their specific hardware and network conditions.

* docs: add timeout configuration documentation

- Add comprehensive timeout troubleshooting section to common-issues.md
- Add FAQ entry about timeout errors during transformations
- Document API_CLIENT_TIMEOUT and ESPERANTO_LLM_TIMEOUT usage
- Provide specific timeout recommendations for different hardware/network scenarios
- Link to GitHub issue #131 for reference

* chore: bump

* refactor: improve timeout configuration with validation and consistency

Based on PR review feedback, this commit addresses several improvements:

**Timeout Validation:**
- Add validation to ensure timeout values are between 30s and 3600s
- Invalid values fall back to default 300s with warning logs
- Handles edge cases (negative, zero, invalid strings)

**Fix Hard-coded Timeouts:**
- Replace all hard-coded timeout values in api/client.py
- ask_simple: 300s → self.timeout
- execute_transformation: 120s → self.timeout
- embed_content: 120s → self.timeout
- create_source: 300s → self.timeout
- rebuild_embeddings: Uses smart logic (2x timeout, max 3600s)

**Improved Documentation:**
- Add clarifying comments about ms vs seconds (frontend vs backend)
- Document that frontend uses 300000ms = backend 300s
- Add inline documentation for rebuild_embeddings timeout logic

**Development Dependencies:**
- Add pytest>=8.0.0 to dev dependencies for future test coverage

This makes timeout configuration more robust, consistent, and user-friendly
while maintaining backward compatibility.
2025-10-19 11:37:24 -03:00
LUIS NOVO
a73ce8e094 fix: better fix to the backend connectivity problem using the react backend for guessing the API URL 2025-10-19 10:16:58 -03:00
LUIS NOVO
9670e3553d remove libmagic references (deprecated) 2025-10-19 09:00:40 -03:00
Luis Novo
04b5a9c96a
Implement a serverside fix for reverse proxy users (#169) 2025-10-19 08:02:21 -03:00
Luis Novo
4c2b8257fc
OpenAI compatible multimodal (#167)
* fix text

* remove lint from docker publish workflow

* gemini base url docs

* feat: add multimodal support for openai-compatible providers

- Add helper function to check OpenAI-compatible provider availability per mode
- Update provider detection to support language, embedding, STT, and TTS modalities
- Implement mode-specific environment variable detection (LLM, EMBEDDING, STT, TTS)
- Maintain backward compatibility with generic OPENAI_COMPATIBLE_BASE_URL
- Add comprehensive unit tests for all configuration scenarios
- Update .env.example with mode-specific environment variables
- Update provider support matrix in ai-models.md
- Create comprehensive openai-compatible.md setup guide

This enables users to configure different OpenAI-compatible endpoints for
different AI capabilities (e.g., LM Studio for language models, dedicated
server for embeddings) while maintaining full backward compatibility.

* upgrade

* chore: change docker release strategy
2025-10-19 07:44:05 -03:00
LUIS NOVO
2b9ef266b4 chore: developer experience 2025-10-18 18:14:16 -03:00
LUIS NOVO
4e5f8c9a6a docs: add GHCR registry information
- Add Docker image registry section explaining both Docker Hub and GHCR options
- Include GHCR alternative in Quick Start examples
- Add comments showing how to use GHCR in docker-compose examples
- Help users understand they can use either registry interchangeably
2025-10-18 13:09:16 -03:00
Luis Novo
b7e656a319
Version 1 (#160)
New front-end
Launch Chat API
Manage Sources
Enable re-embedding of all contents
Sources can be added without a notebook now
Improved settings
Enable model selector on all chats
Background processing for better experience
Dark mode
Improved Notes

Improved Docs: 
- Remove all Streamlit references from documentation
- Update deployment guides with React frontend setup
- Fix Docker environment variables format (SURREAL_URL, SURREAL_PASSWORD)
- Update docker image tag from :latest to :v1-latest
- Change navigation references (Settings → Models to just Models)
- Update development setup to include frontend npm commands
- Add MIGRATION.md guide for users upgrading from Streamlit
- Update quick-start guide with correct environment variables
- Add port 5055 documentation for API access
- Update project structure to reflect frontend/ directory
- Remove outdated source-chat documentation files
2025-10-18 12:46:22 -03:00
LUIS NOVO
124d7d110c docs: TTS_BATCH_SIZE 2025-09-14 11:05:34 -03:00
Luis Novo
fa27fe561a
Several hotfixes (#130)
* fix: prevent project failing to start when cannot talk to github - fixes #128

* improve ollama documentation - see #127

* chore: update esperanto library to enable gpt-5 - see #107; update podcast-creator library to enable TTS_BATCH_SIZE - fixes #125

* add info on ollama env variables

* chore: ignore dev logs

* chore: bump
2025-09-14 10:58:16 -03:00
LUIS NOVO
dcef3751cc docs: docs for openai-compatible 2025-07-27 22:53:36 -03:00
LUIS NOVO
4a79093503 docs: improve docs 2025-07-17 14:37:14 -03:00
LUIS NOVO
dc1a02e35f docs: remove old docs 2025-07-17 12:47:08 -03:00
LUIS NOVO
b20c62df47 docs: new docs 2025-07-17 12:38:40 -03:00
Luis Novo
d7b0fff954
Api podcast migration (#93)
Creates the API layer for Open Notebook
Creates a services API gateway for the Streamlit front-end
Migrates the SurrealDB SDK to the official one
Change all database calls to async
New podcast framework supporting multiple speaker configurations
Implement the surreal-commands library for async processing
Improve docker image and docker-compose configurations
2025-07-17 08:36:11 -03:00
LUIS NOVO
9814103cc8 docs: update reasoning model instructions 2025-06-26 12:12:05 -03:00
LUIS NOVO
69c0840a25 docs: add voyage API requirements 2025-06-10 12:14:28 -03:00
LUIS NOVO
0a5504744c docs: add model guide 2025-06-10 11:51:59 -03:00
LUIS NOVO
6c571db8c4 feat: update models pages 2025-06-09 20:47:20 -03:00
LUIS NOVO
780b905f74 fix discord link 2025-04-24 10:14:59 -03:00
LUIS NOVO
e3fa445fcc point docs to website 2024-11-14 15:46:33 -03:00
LUIS NOVO
cd3ad2e9fa simplify docker setup 2024-11-14 09:50:33 -03:00
LUIS NOVO
51dc60bc82 update docs 2024-11-13 22:08:57 -03:00
LUIS NOVO
867ae9c67b update podcast sample 2024-11-07 20:01:23 -03:00
LUIS NOVO
7978833473 enable gemini text to speech model for podcast generation 2024-11-07 19:45:56 -03:00
LUIS NOVO
35c68dff11 better readme 2024-11-05 13:57:10 -03:00
LUIS NOVO
69477b8726 docs 2024-11-01 17:45:05 -03:00
LUIS NOVO
b89250d3ca temporary fix to config cache 2024-11-01 17:06:10 -03:00
LUIS NOVO
2f2cdabd2d Fix issue with model defaults and bump version 2024-10-30 18:28:29 -03:00
LUIS NOVO
0a868fceb5 remove model info from docs 2024-10-30 14:06:41 -03:00
LUIS NOVO
399f175b0c docker image 2024-10-28 12:03:05 -03:00
LUIS NOVO
424cb8b16a rename repo and add upgrade version check 2024-10-28 09:21:39 -03:00
LUIS NOVO
17114964c7 remove mp3 2024-10-26 10:17:40 -03:00
LUIS NOVO
78bbd4d860 youtube sample for the podcast 2024-10-26 10:15:00 -03:00
LUIS NOVO
8cd123f9ea sample interview 2024-10-26 07:59:19 -03:00
LUIS NOVO
4f90e8f85a update install info 2024-10-26 07:30:28 -03:00
LUIS NOVO
fcabdec751 add podcast feature details 2024-10-26 07:09:44 -03:00
LUIS NOVO
01f8eab10e add podcast support 2024-10-26 05:17:58 -03:00
LUIS NOVO
c3f3c9cb93 update docs to new release info 2024-10-23 15:40:28 -03:00
LUIS NOVO
737bc51f09 update docker image documentation for multi-model 2024-10-22 18:53:04 -03:00
LUIS NOVO
bcd260a28b Initial commit with all features 2024-10-21 14:56:10 -03:00