👁️ ARGUS: The All-Seeing Document Intelligence Platform

Named after Argus Panoptes, the mythological giant with a hundred eyes—ARGUS never misses a detail in your documents.

🚀 Transform Document Processing with AI Intelligence

ARGUS revolutionizes how organizations extract, understand, and act on document data. By combining the precision of Azure Document Intelligence with the contextual reasoning of GPT-5.4, ARGUS doesn't just read documents—it understands them.

💡 Why ARGUS?

Traditional OCR solutions extract text but miss the context. AI-only approaches struggle with complex layouts. ARGUS bridges this gap, delivering enterprise-grade document intelligence that:

🎯 Extracts with Purpose: Understands document context, not just text
⚡ Scales Effortlessly: Process thousands of documents with cloud-native architecture
🔒 Secures by Design: Enterprise security with managed identities and RBAC
🧠 Learns Continuously: Configurable datasets adapt to your specific document types
📊 Measures Success: Built-in evaluation tools ensure consistent accuracy

🌟 Key Capabilities

🔍 Intelligent Document Understanding

Hybrid AI Pipeline: Combines OCR precision with LLM reasoning
Multiple OCR Providers: Azure Document Intelligence or Mistral Document AI
Context-Aware Extraction: Understands relationships between data points
Multi-Format Support: PDFs, images, forms, invoices, medical records
Zero-Shot Learning: Works on new document types without training

⚡ Enterprise-Ready Performance

Cloud-Native Architecture: Built on Azure Container Apps with VNet integration
Scalable Processing: Handle document floods with confidence
Real-Time Processing: API-driven workflows for immediate results
Event-Driven Automation: Automatic processing on document upload
Zero-Credential Security: Managed identity authentication with no API keys

🎛️ Advanced Control & Customization

Dynamic Configuration: Runtime settings without redeployment
Custom Datasets: Tailor extraction for your specific needs
Interactive Chat: Ask questions about processed documents
Concurrency Management: Fine-tune performance for your workload

📈 Comprehensive Analytics

Built-in Evaluation: Multiple accuracy metrics and comparisons
Performance Monitoring: Application Insights integration
Custom Evaluators: Fuzzy matching, semantic similarity, and more
Visual Analytics: Jupyter notebooks for deep analysis

🏗️ Architecture: Built for Scale and Security

ARGUS employs a modern, cloud-native architecture designed for enterprise workloads:

graph TB
subgraph "📥 Document Input"
A[📄 Documents] --> B[📁 Azure Blob Storage]
C[🌐 Direct Upload API] --> D[🚀 FastAPI Backend]
end
subgraph "🧠 AI Processing Engine"
B --> D
D --> E{🔍 OCR Provider}
E -->|Azure| E1[Azure Document Intelligence]
E -->|Mistral| E2[Mistral Document AI]
D --> F[🤖 GPT-5.4]
E1 --> G[⚙️ Hybrid Processing Pipeline]
E2 --> G
F --> G
end
subgraph "💡 Intelligence & Analytics"
G --> H[📊 Custom Evaluators]
G --> I[💬 Interactive Chat]
H --> J[📈 Results & Analytics]
end
subgraph "💾 Data Layer"
G --> K[🗄️ Azure Cosmos DB]
J --> K
I --> K
K --> L[📱 Next.js Frontend]
end
style A fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
style B fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
style C fill:#e8f5e8,stroke:#388e3c,stroke-width:2px
style D fill:#fff3e0,stroke:#f57c00,stroke-width:2px
style E fill:#fce4ec,stroke:#c2185b,stroke-width:2px
style E1 fill:#fce4ec,stroke:#c2185b,stroke-width:2px
style E2 fill:#fce4ec,stroke:#c2185b,stroke-width:2px
style F fill:#e0f2f1,stroke:#00695c,stroke-width:2px
style G fill:#fff8e1,stroke:#ffa000,stroke-width:2px
style H fill:#f1f8e9,stroke:#558b2f,stroke-width:2px
style I fill:#e8eaf6,stroke:#3f51b5,stroke-width:2px
style J fill:#fdf2e9,stroke:#e65100,stroke-width:2px
style K fill:#e0f7fa,stroke:#0097a7,stroke-width:2px
style L fill:#f9fbe7,stroke:#827717,stroke-width:2px

🔧 Infrastructure Components

Component	Technology	Purpose
🚀 Backend API	Azure Container Apps + FastAPI	High-performance document processing engine
📱 Frontend UI	Next.js (React)	Modern document management interface
📁 Document Storage	Azure Blob Storage	Secure, scalable document repository
🗄️ Metadata Database	Azure Cosmos DB	Results, configurations, and analytics
🔍 OCR Engine	Azure Document Intelligence or Mistral Document AI	Structured text and layout extraction
🧠 AI Reasoning	Azure OpenAI (GPT-5.4)	Contextual understanding and extraction
🏗️ Container Registry	Azure Container Registry	Private, secure container images
🔒 Security	Managed Identity + RBAC	Zero-credential architecture
🌐 Network	VNet + Private Endpoints	Network isolation for all Azure services
🔑 Secrets	Azure Key Vault	Centralized secrets management
📊 Monitoring	Application Insights	Performance and health monitoring

🔒 Security Architecture

ARGUS implements a defense-in-depth security model:

Network Isolation

VNet Integration: All Container Apps run within a dedicated Virtual Network (10.0.0.0/16)
Private Endpoints: Storage, Cosmos DB, OpenAI, Document Intelligence, and Key Vault are accessible only through private endpoints
Private DNS Zones: Automatic DNS resolution for private endpoints via Azure Private DNS
No Public Access: All backend services have publicNetworkAccess: Disabled

Identity & Authentication

Managed Identity: User-assigned managed identity for all service-to-service authentication
No API Keys: Local authentication is disabled on all Azure services (disableLocalAuth: true)
No Shared Keys: Storage account shared key access is disabled (allowSharedKeyAccess: false)
RBAC-Only Access: All permissions are granted through Azure RBAC role assignments

RBAC Roles (Principle of Least Privilege)

Role	Scope	Purpose
Storage Blob Data Contributor	Storage Account	Read/write blob data
Cosmos DB Built-in Data Contributor	Cosmos DB Account	Read/write database items
Cognitive Services User	Document Intelligence	OCR operations
Cognitive Services OpenAI User	Azure OpenAI	Model inference
Key Vault Secrets User	Key Vault	Read secrets
AcrPull	Container Registry	Pull container images

⚡ Quick Start: Deploy in Minutes

📋 Prerequisites

🛠️ Required Tools (Click to expand)

Docker

# Install Docker (required for containerization during deployment)# Visit https://docs.docker.com/get-docker/ for installation instructions

Azure Developer CLI (azd)

curl -fsSL https://aka.ms/install-azd.sh | bash

Azure CLI

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Azure Subscription
- An active Azure subscription with permissions to create resources
- The deployment automatically provisions all required Azure services (OpenAI, Storage, Cosmos DB, etc.)
- Authentication uses managed identity — no API keys required

🚀 One-Command Deployment

# 1. Clone the repository
git clone https://github.com/Azure-Samples/ARGUS.git
cd ARGUS
# 2. Login to Azure
az login
# 3. Deploy everything with a single command
azd up

That's it! 🎉 Your ARGUS instance is now running in the cloud.

✅ Verify Your Deployment

# Check system health
curl "$(azd env get-value BACKEND_URL)/health"# Expected response:
{
"status": "healthy",
"services": {
"cosmos_db": "✅ connected",
"blob_storage": "✅ connected", "document_intelligence": "✅ connected",
"azure_openai": "✅ connected"
}
}
# View live application logs
azd logs --follow

🎮 Usage Examples: See ARGUS in Action

📄 Method 1: Upload via Frontend Interface (Recommended)

The easiest way to process documents is through the user-friendly web interface:

Access the Frontend:

# Get the frontend URL after deployment
azd env get-value FRONTEND_URL

Upload and Process Documents:
- Navigate to the "🧠 Process Files" tab
- Select your dataset from the dropdown (e.g., "default-dataset", "medical-dataset")
- Use the file uploader to select PDF, image, or Office documents
- Click "Submit" to upload files
- Files are automatically processed using the selected dataset's configuration
- Monitor processing status in the "🔍 Explore Data" tab

📤 Method 2: Direct Blob Storage Upload

For automation or bulk processing, upload files directly to Azure Blob Storage:

# Upload a document to be processed automatically
az storage blob upload \
--account-name "$(azd env get-value STORAGE_ACCOUNT_NAME)" \
--container-name "datasets" \
--name "default-dataset/invoice-2024.pdf" \
--file "./my-invoice.pdf" \
--auth-mode login
# Files uploaded to blob storage are automatically detected and processed# Results can be viewed in the frontend or retrieved via API

💬 Example 3: Interactive Document Chat

Ask questions about any processed document through the API:

curl -X POST \
-H "Content-Type: application/json" \
-d '{ "blob_url": "https://mystorage.blob.core.windows.net/datasets/default-dataset/contract.pdf", "question": "What are the key terms and conditions in this contract?" }' \
"$(azd env get-value BACKEND_URL)/api/chat"# Get intelligent answers:
{
"answer": "The key terms include: 1) 12-month service agreement, 2) $5000/month fee, 3) 30-day termination clause...",
"confidence": 0.91,
"sources": ["page 1, paragraph 3", "page 2, section 2.1"]
}

🤖 MCP Integration: AI-Powered Document Access

ARGUS supports the Model Context Protocol (MCP) using the modern Streamable HTTP transport, enabling AI assistants like GitHub Copilot, Claude, and other MCP-compatible clients to interact directly with your document intelligence platform.

🔌 What is MCP?

The Model Context Protocol is an open standard that allows AI assistants to securely connect to external data sources and tools. With ARGUS MCP support, your AI assistant can:

📄 List and search documents across all your datasets
🔍 Query document content and extracted data
💬 Chat with documents using natural language
📤 Upload new documents for processing
⚙️ Manage datasets and configurations

⚡ Quick Setup

Add ARGUS to your MCP client configuration:

VS Code / GitHub Copilot (~/.vscode/mcp.json or workspace settings):

{
"mcpServers": {
"argus": {
"url": "https://<your-backend-url>/mcp"
}
}
}

Tip: After deployment with azd up, get your backend URL from the Azure Portal or run azd show to find the Container App URL.

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
"mcpServers": {
"argus": {
"url": "https://<your-backend-url>/mcp"
}
}
}

Note: ARGUS uses the Streamable HTTP transport (the modern MCP standard). The endpoint is a single /mcp path that handles all MCP communication.

🛠️ Available MCP Tools

Tool	Description
`argus_list_documents`	List all processed documents with filtering options
`argus_get_document`	Get detailed document information including OCR and extraction results
`argus_chat_with_document`	Ask natural language questions about a document
`argus_search_documents`	Search documents by keyword across all datasets
`argus_list_datasets`	List available dataset configurations
`argus_get_dataset_config`	Get system prompt and schema for a dataset
`argus_create_dataset`	Create a new dataset with custom prompt and schema
`argus_process_document_url`	Queue a document for processing from blob URL
`argus_get_extraction`	Get extracted structured data from a document
`argus_get_upload_url`	Get a pre-signed SAS URL for direct document upload

💡 Example Interactions

Once configured, you can interact with ARGUS through your AI assistant:

User: "Show me all invoices processed in the last week"
AI: [Uses argus_list_documents to retrieve recent invoices]
User: "What's the total amount on invoice INV-2024-001?"
AI: [Uses argus_get_document to fetch invoice details]
User: "I need to upload a new contract for processing"
AI: [Uses argus_get_upload_url to get a secure upload link]
User: "Compare the extraction results between these two invoices"
AI: [Uses argus_get_extraction on both documents and compares]
User: "Create a new dataset for processing purchase orders"
AI: [Uses argus_create_dataset with appropriate prompt and schema]

🎛️ Advanced Configuration

📊 Dataset Management

ARGUS uses datasets to define how different types of documents should be processed. A dataset contains:

Model Prompt: Instructions telling the AI how to extract data from documents
Output Schema: The target structure for extracted data (can be empty to let AI determine the structure)
Processing Options: Settings for OCR, image analysis, summarization, and evaluation

When to create custom datasets: Create a new dataset when you have a specific document type that requires different extraction logic than the built-in datasets (e.g., contracts, medical reports, financial statements).

🗂️ Built-in Datasets

default-dataset/: Invoices, receipts, general business documents
medical-dataset/: Medical forms, prescriptions, healthcare documents

🔧 Create Custom Datasets

Datasets are managed through the web frontend interface (deployed automatically with azd):

Access the frontend (URL provided after azd deployment)
Navigate to the Process Files tab
Scroll to "Add New Dataset" section
Configure your dataset:
- Enter dataset name (e.g., "legal-contracts")
- Define model prompt with extraction instructions
- Specify output schema (JSON format) or leave empty
- Set processing options (OCR, images, evaluation)
Click "Add New Dataset" - it's saved directly to Cosmos DB

� OCR Provider Configuration

ARGUS supports two OCR providers for document text extraction:

Azure Document Intelligence (Default): Microsoft's enterprise OCR service with advanced layout understanding
Mistral Document AI: Mistral's document processing service with markdown-optimized output

🔧 Configure OCR Provider

Via Frontend (Recommended):

Navigate to Settings tab in the web interface
Select OCR Provider section
Choose your provider:
- Azure: Uses Azure Document Intelligence (automatically configured during deployment)
- Mistral: Requires additional configuration (endpoint, API key, model name)
For Mistral, enter:
- Mistral Endpoint: Your Mistral Document AI API endpoint URL
- Mistral API Key: Your Mistral API authentication key
- Mistral Model: Model name (default: mistral-document-ai-2505)
Click "Update OCR Provider" to apply changes

Via Environment Variables: Set the following environment variables in your deployment:

# Choose OCR provider
OCR_PROVIDER=mistral # or "azure" (default)# Mistral-specific configuration (only needed if OCR_PROVIDER=mistral)
MISTRAL_DOC_AI_ENDPOINT=https://your-endpoint.services.ai.azure.com/providers/mistral/azure/ocr
MISTRAL_DOC_AI_KEY=your-mistral-api-key
MISTRAL_DOC_AI_MODEL=mistral-document-ai-2505

Update via Azure Portal:

Navigate to Azure Portal → Container Apps → Your Backend App
Go to Settings → Environment variables
Add/update the variables listed above
Restart the container app

Update via Azure CLI:

# Switch to Mistral
az containerapp update \
--name <your-backend-app-name> \
--resource-group <your-resource-group> \
--set-env-vars \
OCR_PROVIDER="mistral" \
MISTRAL_DOC_AI_ENDPOINT="https://your-endpoint.../ocr" \
MISTRAL_DOC_AI_KEY="your-api-key" \
MISTRAL_DOC_AI_MODEL="mistral-document-ai-2505"# Switch back to Azure
az containerapp update \
--name <your-backend-app-name> \
--resource-group <your-resource-group> \
--set-env-vars OCR_PROVIDER="azure"

Note: OCR provider selection is configured at the solution level and applies to all document processing operations.

The Streamlit frontend is automatically deployed with azd up and provides a user-friendly interface for document management.

Note: ARGUS ships with two frontends: a modern Next.js interface (default, deployed as ca-frontend) and a legacy Streamlit interface. The Next.js frontend is recommended for production use.

🎯 Frontend Features

Tab	Functionality
🧠 Process Files	Drag-and-drop document upload with real-time processing status
🔍 Explore Data	Browse processed documents, search results, view extraction details
⚙️ Settings	Configure datasets, adjust processing parameters, manage connections
📋 Instructions	Interactive help, API documentation, and usage examples

️ Development & Customization

🏗️ Project Structure Deep Dive

ARGUS/
├── 📋 azure.yaml # Azure Developer CLI configuration
├── 📄 README.md # Project documentation & setup guide
├── 📄 LICENSE # MIT license file
├── 📄 CONTRIBUTING.md # Contribution guidelines
├── 📄 sample-invoice.pdf # Sample document for testing
├── 🔧 .env.template # Environment variables template
├── 📂 .github/ # GitHub Actions & workflows
├── 📂 .devcontainer/ # Development container configuration
├── 📂 .vscode/ # VS Code settings & extensions
│
├── 📂 infra/ # 🏗️ Azure Infrastructure as Code
│ ├── ⚙️ main.bicep # Orchestrator Bicep template (calls modules)
│ ├── ⚙️ main.parameters.json # Infrastructure parameters & configuration
│ ├── ⚙️ main-containerapp.bicep # Container App specific infrastructure
│ ├── ⚙️ main-containerapp.parameters.json # Container App parameters
│ ├── 📋 abbreviations.json # Azure resource naming abbreviations
│ └── 📂 modules/ # Modular Bicep components
│ ├── ⚙️ network.bicep # VNet, subnets, private DNS zones
│ ├── ⚙️ identity.bicep # User-assigned managed identity
│ ├── ⚙️ storage.bicep # Storage account + private endpoint
│ ├── ⚙️ cosmos.bicep # Cosmos DB + private endpoint
│ ├── ⚙️ ai-services.bicep # Azure OpenAI + model deployment + PE
│ ├── ⚙️ document-intelligence.bicep # Doc Intelligence + private endpoint
│ ├── ⚙️ key-vault.bicep # Key Vault + private endpoint
│ ├── ⚙️ container-registry.bicep # ACR for container images
│ ├── ⚙️ container-apps.bicep # CAE + backend/frontend container apps
│ ├── ⚙️ role-assignments.bicep # RBAC role assignments
│ ├── ⚙️ monitoring.bicep # Application Insights + Log Analytics
│ └── ⚙️ event-processing.bicep # Event Grid subscriptions
│
├── 📂 src/ # 🚀 Core Application Source Code
│ ├── 📂 containerapp/ # FastAPI Backend Service
│ │ ├── 🚀 main.py # FastAPI app lifecycle & configuration
│ │ ├── 🔌 api_routes.py # HTTP endpoints & request handlers
│ │ ├── 🔧 dependencies.py # Azure client initialization & management
│ │ ├── 📋 models.py # Pydantic data models & schemas
│ │ ├── ⚙️ blob_processing.py # Document processing pipeline orchestration
│ │ ├── 🎛️ logic_app_manager.py # Azure Logic Apps concurrency management
│ │ ├── 🐳 Dockerfile # Container image definition
│ │ ├── 📦 requirements.txt # Python dependencies
│ │ ├── 📄 REFACTORING_SUMMARY.md # Architecture documentation
│ │ │
│ │ ├── 📂 ai_ocr/ # 🧠 AI Processing Engine
│ │ │ ├── 🔍 process.py # Main processing orchestration & workflow
│ │ │ ├── 🔗 chains.py # LangChain integration & AI workflows
│ │ │ ├── 🤖 model.py # Configuration models & data structures
│ │ │ ├── ⏱️ timeout.py # Processing timeout management
│ │ │ │
│ │ │ └── 📂 azure/ # ☁️ Azure Service Integrations
│ │ │ ├── ⚙️ config.py # Environment & configuration management
│ │ │ ├── 📄 doc_intelligence.py # Azure Document Intelligence OCR
│ │ │ ├── 🖼️ images.py # PDF to image conversion utilities
│ │ │ └── 🤖 openai_ops.py # Azure OpenAI API operations
│ │ │
│ │ ├── 📂 example-datasets/ # 📊 Default Dataset Configurations
│ │ ├── 📂 datasets/ # 📁 Runtime dataset storage
│ │ └── 📂 evaluators/ # 📈 Data quality evaluation modules
│ │
│ └── 📂 evaluators/ # 🧪 Evaluation Framework
│ ├── 📋 field_evaluator_base.py # Abstract base class for evaluators
│ ├── 🔤 fuzz_string_evaluator.py # Fuzzy string matching evaluation
│ ├── 🎯 cosine_similarity_string_evaluator.py # Semantic similarity evaluation
│ ├── 🎛️ custom_string_evaluator.py # Custom evaluation logic
│ ├── 📊 json_evaluator.py # JSON structure validation
│ └── 📂 tests/ # Unit tests for evaluators
│
├── 📂 frontend-next/ # 🖥️ Next.js Web Interface
│ ├── 📱 src/app/ # App Router pages and API routes
│ │ ├── 📄 page.tsx # Home page with document processing
│ │ ├── 📂 explore/ # Document browsing & analysis
│ │ ├── 📂 settings/ # Configuration management
│ │ ├── 📂 instructions/ # Help & documentation
│ │ ├── 📂 api-docs/ # API reference documentation
│ │ ├── 📂 mcp/ # MCP integration info
│ │ └── 📂 api/ # Backend proxy API routes
│ ├── 📂 src/components/ # Reusable React components
│ ├── 📂 src/lib/ # API client & utilities
│ ├── 🐳 Dockerfile # Frontend container definition
│ ├── 📦 package.json # Node.js dependencies
│ └── ⚙️ next.config.js # Next.js configuration
│
├── 📂 frontend/ # 🖥️ Legacy Streamlit Interface
│ ├── 📱 app.py # Main Streamlit application entry point
│ ├── 🔄 backend_client.py # API client for backend communication
│ ├── 📤 process_files.py # File upload & processing interface
│ ├── 🔍 explore_data.py # Document browsing & analysis UI
│ ├── 💬 document_chat.py # Interactive document Q&A interface
│ ├── 📋 instructions.py # Help & documentation tab
│ ├── ⚙️ settings.py # Configuration management UI
│ ├── 🎛️ concurrency_management.py # Performance tuning interface
│ ├── 📊 concurrency_settings.py # Concurrency configuration utilities
│ ├── 🐳 Dockerfile # Frontend container definition
│ ├── 📦 requirements.txt # Python dependencies for frontend
│ └── 📂 static/ # Static assets (logos, images)
│ └── 🖼️ logo.png # ARGUS brand logo
│
├── 📂 demo/ # 📋 Sample Datasets & Examples
│ ├── 📂 default-dataset/ # General business documents dataset
│ │ ├── 📄 system_prompt.txt # AI extraction instructions
│ │ ├── 📊 output_schema.json # Expected data structure
│ │ ├── 📄 ground_truth.json # Validation reference data
│ │ └── 📄 Invoice Sample.pdf # Sample document for testing
│ │
│ └── 📂 medical-dataset/ # Healthcare documents dataset
│ ├── 📄 system_prompt.txt # Medical-specific extraction rules
│ ├── 📊 output_schema.json # Medical data structure
│ └── 📄 eyes_surgery_pre_1_4.pdf # Sample medical document
│
├── 📂 notebooks/ # 📈 Analytics & Evaluation Tools
│ ├── 🧪 evaluator.ipynb # Comprehensive evaluation dashboard
│ ├── 📊 output.json # Evaluation results & metrics
│ ├── 📦 requirements.txt # Jupyter notebook dependencies
│ ├── 📄 README.md # Notebook usage instructions
│ └── 📂 outputs/ # Historical evaluation results
│
└── 📂 docs/ # 📚 Documentation & Assets
└── 🖼️ ArchitectureOverview.png # System architecture diagram

🧪 Local Development Setup

# Setup development environmentcd src/containerapp
python -m venv venv
source venv/bin/activate # or `venv\Scripts\activate` on Windows
pip install -r requirements.txt
# Configure local environment
cp ../../.env.template .env
# Edit .env with your development credentials# Run with hot reload
uvicorn main:app --reload --host 0.0.0.0 --port 8000
# Access API documentation
open http://localhost:8000/docs

🔧 Key Technologies & Libraries

Category	Technologies
🚀 API Framework	FastAPI, Uvicorn, Pydantic
🧠 AI/ML	LangChain, OpenAI SDK, Azure AI SDK
☁️ Azure Services	Azure SDK (Blob, Cosmos, Document Intelligence, Key Vault)
📱 Frontend	Next.js 15, React, Tailwind CSS, shadcn/ui
📄 Document Processing	PyMuPDF, Pillow, PyPDF2
📊 Data & Analytics	Pandas, NumPy, Matplotlib
🔒 Security	Azure Identity, managed identities, Private Endpoints

API Reference: Complete Documentation

🚀 Core Processing Endpoints

📄 POST /api/process-blob - Process Document from Storage

Request:

{
"blob_url": "https://storage.blob.core.windows.net/datasets/default-dataset/invoice.pdf",
"dataset_name": "default-dataset",
"priority": "normal",
"webhook_url": "https://your-app.com/webhooks/argus",
"metadata": {
"source": "email_attachment",
"user_id": "user123"
}
}

Response:

{
"status": "success",
"job_id": "job_12345",
"extraction_results": {
"invoice_number": "INV-2024-001",
"total_amount": "$1,250.00",
"confidence_score": 0.94
},
"processing_time": "2.3s",
"timestamp": "2024-01-15T10:30:00Z"
}

📤 POST /api/process-file - Direct File Upload

Request (multipart/form-data):

file: [PDF/Image file]
dataset_name: "default-dataset"
priority: "high"

Response:

{
"status": "success",
"job_id": "job_12346",
"blob_url": "https://storage.blob.core.windows.net/temp/uploaded_file.pdf",
"extraction_results": {...},
"processing_time": "1.8s"
}

💬 POST /api/chat - Interactive Document Q&A

Request:

{
"blob_url": "https://storage.blob.core.windows.net/datasets/contract.pdf",
"question": "What are the payment terms and penalties for late payment?",
"context": "focus on financial obligations",
"temperature": 0.1
}

Response:

{
"answer": "Payment terms are Net 30 days. Late payment penalty is 1.5% per month on outstanding balance...",
"confidence": 0.91,
"sources": [
{"page": 2, "section": "Payment Terms"},
{"page": 5, "section": "Default Provisions"}
],
"processing_time": "1.2s"
}

⚙️ Configuration Management

🔧 GET/POST /api/configuration - System Configuration

GET Response:

{
"openai_settings": {
"endpoint": "https://your-openai.openai.azure.com/",
"model": "gpt-5.4",
"temperature": 0.1,
"max_tokens": 4000
},
"processing_settings": {
"max_concurrent_jobs": 5,
"timeout_seconds": 300,
"retry_attempts": 3
},
"datasets": ["default-dataset", "medical-dataset", "financial-reports"]
}

POST Request:

{
"openai_settings": {
"temperature": 0.05,
"max_tokens": 6000
},
"processing_settings": {
"max_concurrent_jobs": 8
}
}

📊 Monitoring & Analytics

📈 GET /api/metrics - Performance Metrics

Response:

{
"period": "last_24h",
"summary": {
"total_documents": 1247,
"successful_extractions": 1198,
"failed_extractions": 49,
"success_rate": 96.1,
"avg_processing_time": "2.3s"
},
"performance": {
"p50_processing_time": "1.8s",
"p95_processing_time": "4.2s",
"p99_processing_time": "8.1s"
},
"errors": {
"ocr_failures": 12,
"ai_timeouts": 8,
"storage_issues": 3,
"other": 26
}
}

Contributing & Community

🎯 How to Contribute

We welcome contributions! Here's how to get started:

🍴 Fork & Clone:

git clone https://github.com/your-username/ARGUS.git
cd ARGUS

🌿 Create Feature Branch:

git checkout -b feature/amazing-improvement

🧪 Develop & Test:

# Setup development environment
./scripts/setup-dev.sh
# Run tests
pytest tests/ -v
# Lint code
black src/ && flake8 src/

📝 Document Changes:

# Update documentation# Add examples to README# Update API documentation

🚀 Submit PR:

git commit -m "feat: add amazing improvement"
git push origin feature/amazing-improvement
# Create pull request on GitHub

📋 Contribution Guidelines

Type	Guidelines
🐛 Bug Fixes	Include reproduction steps, expected vs actual behavior
✨ New Features	Discuss in issues first, include tests and documentation
📚 Documentation	Clear examples, practical use cases, proper formatting
🔧 Performance	Benchmark results, before/after comparisons

🏆 Recognition

Contributors will be recognized in:

📝 Release notes for significant contributions
🌟 Contributors section (with permission)
💬 Community showcase for innovative use cases

📞 Support & Resources

💬 Getting Help

Resource	Description	Link
📚 Documentation	Complete setup and usage guides	docs/
�🐛 Issue Tracker	Bug reports and feature requests	GitHub Issues
💡 Discussions	Community Q&A and ideas	GitHub Discussions
📧 Team Contact	Direct contact for enterprise needs	See team section below

🔗 Additional Resources

📖 Azure Document Intelligence: Official Documentation
🤖 Azure OpenAI: Service Documentation
⚡ FastAPI: Framework Documentation
🐍 LangChain: Integration Guides

👥 Team

Alberto Gallo
Petteri Johansson
Christin Pohl
Konstantinos Mavrodis

License

This project is licensed under the MIT License - see the LICENSE file for details.

🚀 Ready to Transform Your Document Processing?

Deploy ARGUS in minutes and start extracting intelligence from your documents today!

git clone https://github.com/Azure-Samples/ARGUS.git &&cd ARGUS && azd up

⭐ Star this repo if ARGUS helps your document processing needs!

Name		Name	Last commit message	Last commit date
.devcontainer		.devcontainer
.github		.github
.vscode		.vscode
demo		demo
docs		docs
frontend-next		frontend-next
frontend		frontend
infra		infra
notebooks		notebooks
src		src
.env.template		.env.template
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
api_documentation.md		api_documentation.md
azure.yaml		azure.yaml

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

👁️ ARGUS: The All-Seeing Document Intelligence Platform

🚀 Transform Document Processing with AI Intelligence

💡 Why ARGUS?

🌟 Key Capabilities

🔍 Intelligent Document Understanding

⚡ Enterprise-Ready Performance

🎛️ Advanced Control & Customization

📈 Comprehensive Analytics

🏗️ Architecture: Built for Scale and Security

🔧 Infrastructure Components

🔒 Security Architecture

Network Isolation

Identity & Authentication

RBAC Roles (Principle of Least Privilege)

⚡ Quick Start: Deploy in Minutes

📋 Prerequisites

🚀 One-Command Deployment

✅ Verify Your Deployment

🎮 Usage Examples: See ARGUS in Action

📄 Method 1: Upload via Frontend Interface (Recommended)

📤 Method 2: Direct Blob Storage Upload

💬 Example 3: Interactive Document Chat

🤖 MCP Integration: AI-Powered Document Access

🔌 What is MCP?

⚡ Quick Setup

🛠️ Available MCP Tools

💡 Example Interactions

🎛️ Advanced Configuration

📊 Dataset Management

� OCR Provider Configuration

🎯 Frontend Features

️ Development & Customization

🏗️ Project Structure Deep Dive

🧪 Local Development Setup

🔧 Key Technologies & Libraries

API Reference: Complete Documentation

🚀 Core Processing Endpoints

⚙️ Configuration Management

📊 Monitoring & Analytics

Contributing & Community

🎯 How to Contribute

📋 Contribution Guidelines

🏆 Recognition

📞 Support & Resources

💬 Getting Help

🔗 Additional Resources

👥 Team

License

🚀 Ready to Transform Your Document Processing?

About

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages