{"id":"leo-capvano-generative-ai-demos","name":"generative_ai_demos","homepage":"https://github.com/leo-capvano/generative_ai_demos","repo_url":"https://github.com/leo-capvano/generative_ai_demos","category":"ai-ml","subcategories":[],"tags":["ai-ml","rag","langchain","streamlit","postgres","pgvector","semantic-search","openai","azure-openai","ollama","fastapi"],"what_it_does":"A Python demo app for generative AI knowledge management using Retrieval-Augmented Generation (RAG). It provides (1) a Streamlit-based RAG storage admin panel backed by Postgres/pgvector via docker-compose, (2) legacy LLM interaction, (3) RAG-based LLM interaction that selects context via semantic search, and (4) an OpenAI-function/tool-agent runner with intermediate step visibility. It supports OpenAI, Azure OpenAI, and local Ollama (Mistral) via environment variable configuration.","use_cases":["Local/demo RAG ingestion, semantic search, and administration (insert/read/query).","Interactive Q&A over stored documents with semantic context selection.","LLM “legacy” chat without retrieval for general-purpose prompts.","Agentic tool use demos (tool calling, including inserting results back into the RAG knowledge store).","Hands-on evaluation of OpenAI vs Azure OpenAI vs Ollama/Mistral setups."],"not_for":["Production deployment without additional hardening (authz/authn, monitoring, and operational controls are not described).","Enterprise compliance needs (no compliance/security guarantees documented).","Use cases requiring a stable, versioned public API/SDK contract (the repo appears demo-oriented)."],"best_when":"You want a learning/demo environment to understand RAG workflows and LangChain tool/agent patterns, either with OpenAI/Azure OpenAI or with local Ollama.","avoid_when":"You need a secure, multi-tenant service with robust access control, or a well-specified external API suitable for long-term automated integration.","alternatives":["LangChain RAG examples with their own structured demos","OpenAI/Azure OpenAI reference RAG implementations","LlamaIndex RAG tutorials (including pgvector/Postgres backends)","FastAPI-based RAG starters with OpenAPI specs and auth (various community templates)"],"af_score":26.5,"security_score":28.2,"reliability_score":25.0,"package_type":"skill","discovery_source":["openclaw"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T19:49:06.824377+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["python"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["OpenAI API key via environment variables (implied)","Azure OpenAI credentials via environment variables (implied)","No explicit app-level user auth described; likely relies on local use/demo configuration"],"oauth":false,"scopes":false,"notes":"README mentions an external OpenAI key and a dot_env_template for a .env file, and selection of LLM/embeddings via env vars (llm_impl, embeddings_model_impl). No documentation of API endpoints requiring auth or app-level authentication/authorization is provided."},"pricing":{"model":"OpenAI / Azure OpenAI (or local Ollama).","free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":true,"estimated_workload_costs":null,"notes":"If using OpenAI/Azure OpenAI backends, costs depend on model usage. No cost estimates or quotas are documented. Local Ollama avoids API costs but has infrastructure/hardware requirements."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":26.5,"security_score":28.2,"reliability_score":25.0,"mcp_server_quality":0.0,"documentation_accuracy":55.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":60.0,"rate_limit_clarity":0.0,"tls_enforcement":30.0,"auth_strength":25.0,"scope_granularity":0.0,"dependency_hygiene":40.0,"secret_handling":50.0,"security_notes":"Security controls for the app itself are not described. The README suggests using a .env template for keys (better than hardcoding) but does not confirm safe secret handling practices (e.g., no logging) or transport guarantees. TLS enforcement for any externally exposed service is not specified; Streamlit default setups vary. Dependency hygiene and CVE status cannot be determined from the provided content.","uptime_documented":0.0,"version_stability":30.0,"breaking_changes_history":40.0,"error_recovery":30.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Demo-centric UI/flows (Streamlit) are not described as an agent-facing programmatic API; automation may require screen-scraping or code-level integration.","RAG content insertion/knowledge updates are tool-driven in the agent demo, but idempotency/duplicate handling is not documented.","Operational dependencies (Postgres/pgvector via docker-compose, env var configuration) can break the flow if not set correctly; missing diagnostics may slow agents down.","Agent intermediate steps are displayed in the UI, but no structured machine-readable traces are described."]}}