How uktrade/redbox works
Redbox is a document-ingestion and retrieval-augmented chat application for civil-service documents. Users upload documents for extraction, chunking, and indexing, then ask questions or request summaries; the runtime can retrieve source material and stream responses. The graph includes the Django-facing chat and upload interface, the RAG/agent runtime, ingestion, and shared settings/state. Edges follow shown imports or calls and README descriptions; several Django-to-engine and external-service integrations are not explicit in the excerpts, so those links are omitted.
Main entry points: app.py RAG application · ingester.py File ingestion · chat-controller.js Chat interface · retrievers.py Document retrieval
Components 25
User experience
- Chat interface
django_app/frontend/src/js/web-components/chats/chat-controller.js - Message input
django_app/frontend/src/js/web-components/chats/message-input.js - Chat messages
django_app/frontend/src/js/web-components/chats/chat-message.js - File upload UI
django_app/frontend/src/js/web-components/documents/file-upload.js
Document ingestion
- File ingestion
redbox/redbox/loader/ingester.py - Content extraction
redbox/redbox/loader/extraction/service.py - Document chunking
redbox/redbox/loader/chunking/service.py - Ingest chains
redbox/redbox/chains/ingest.py - Vector index
RAG runtime
- Redbox API
redbox/redbox/api/wrapper.py - RAG application
redbox/redbox/app.py - Agent graph
redbox/redbox/graph/root.py - Agent configurations
redbox/redbox/graph/agents/configs.py - RAG chain components
redbox/redbox/chains/components.py - Document retrieval
redbox/redbox/retriever/retrievers.py - Retrieval queries
redbox/redbox/retriever/queries.py - Agent prompts
redbox/redbox/models/prompts.py - Chat and run state
redbox/redbox/models/chain.py
Application platform
- Application data
django_app/redbox_app/redbox_core/models.py - Web request handlers
django_app/redbox_app/redbox_core/views - Ingestion worker
django_app/redbox_app/worker.py - Runtime settings
redbox/redbox/models/settings.py
Other components
- Civil servant
- Document object storage
- Language model
Connections 24
- Civil servant → Chat interface: uses
README.md - Chat interface → Message input: renders
django_app/frontend/src/js/chats.js - Chat interface → Chat messages: uses
django_app/frontend/src/js/web-components/chats/chat-controller.js - Civil servant → File upload UI: uploads documents
README.md - Ingestion worker → File ingestion: invokes
django_app/redbox_app/worker.py - File ingestion → Content extraction: extracts content
redbox/redbox/loader/ingester.py - Content extraction → Document object storage: reads files
- File ingestion → Ingest chains: builds ingest flow
redbox/redbox/loader/ingester.py - Ingest chains → Document chunking: chunks content
redbox/redbox/chains/ingest.py - File ingestion → Vector index: indexes chunks
redbox/redbox/loader/ingester.py - Civil servant → Redbox API: asks or summarizes
README.md - Redbox API → RAG application: wraps
redbox/redbox/app.py - RAG application → Agent graph: executes graph
redbox/redbox/app.py - RAG application → Agent configurations: configures agents
redbox/redbox/app.py - RAG application → RAG chain components: uses chains
redbox/redbox/app.py - RAG chain components → Document retrieval: retrieves documents
redbox/redbox/chains/components.py - Document retrieval → Retrieval queries: builds queries
redbox/redbox/retriever/retrievers.py - Document retrieval → Vector index: searches index
redbox/redbox/retriever/retrievers.py - Agent configurations → Agent prompts: configures prompts
redbox/redbox/graph/agents/configs.py - RAG application → Chat and run state: uses run state
redbox/redbox/app.py - RAG application → Runtime settings: loads settings
redbox/redbox/app.py - RAG application → Language model: generates responses
- File upload UI → Web request handlers: submits files
- Web request handlers → Application data: accesses records