openrag 0.1.8__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- openrag-0.1.8/MANIFEST.in +1 -0
- openrag-0.1.8/PKG-INFO +199 -0
- openrag-0.1.8/README.md +168 -0
- openrag-0.1.8/documents/2506.08231v1.pdf +0 -0
- openrag-0.1.8/documents/ai-human-resources.pdf +0 -0
- openrag-0.1.8/documents/warmup_ocr.pdf +0 -0
- openrag-0.1.8/pyproject.toml +52 -0
- openrag-0.1.8/setup.cfg +4 -0
- openrag-0.1.8/src/agent.py +641 -0
- openrag-0.1.8/src/api/__init__.py +0 -0
- openrag-0.1.8/src/api/auth.py +84 -0
- openrag-0.1.8/src/api/chat.py +159 -0
- openrag-0.1.8/src/api/connector_router.py +67 -0
- openrag-0.1.8/src/api/connectors.py +375 -0
- openrag-0.1.8/src/api/flows.py +66 -0
- openrag-0.1.8/src/api/knowledge_filter.py +468 -0
- openrag-0.1.8/src/api/langflow_files.py +281 -0
- openrag-0.1.8/src/api/nudges.py +43 -0
- openrag-0.1.8/src/api/oidc.py +111 -0
- openrag-0.1.8/src/api/router.py +183 -0
- openrag-0.1.8/src/api/search.py +54 -0
- openrag-0.1.8/src/api/settings.py +106 -0
- openrag-0.1.8/src/api/tasks.py +35 -0
- openrag-0.1.8/src/api/upload.py +204 -0
- openrag-0.1.8/src/auth_context.py +75 -0
- openrag-0.1.8/src/auth_middleware.py +86 -0
- openrag-0.1.8/src/config/__init__.py +0 -0
- openrag-0.1.8/src/config/settings.py +401 -0
- openrag-0.1.8/src/connectors/__init__.py +11 -0
- openrag-0.1.8/src/connectors/base.py +149 -0
- openrag-0.1.8/src/connectors/connection_manager.py +522 -0
- openrag-0.1.8/src/connectors/google_drive/__init__.py +4 -0
- openrag-0.1.8/src/connectors/google_drive/connector.py +986 -0
- openrag-0.1.8/src/connectors/google_drive/oauth.py +152 -0
- openrag-0.1.8/src/connectors/langflow_connector_service.py +302 -0
- openrag-0.1.8/src/connectors/onedrive/__init__.py +4 -0
- openrag-0.1.8/src/connectors/onedrive/connector.py +223 -0
- openrag-0.1.8/src/connectors/onedrive/oauth.py +95 -0
- openrag-0.1.8/src/connectors/service.py +352 -0
- openrag-0.1.8/src/connectors/sharepoint/__init__.py +4 -0
- openrag-0.1.8/src/connectors/sharepoint/connector.py +229 -0
- openrag-0.1.8/src/connectors/sharepoint/oauth.py +96 -0
- openrag-0.1.8/src/main.py +1049 -0
- openrag-0.1.8/src/models/__init__.py +0 -0
- openrag-0.1.8/src/models/processors.py +440 -0
- openrag-0.1.8/src/models/tasks.py +45 -0
- openrag-0.1.8/src/openrag.egg-info/PKG-INFO +199 -0
- openrag-0.1.8/src/openrag.egg-info/SOURCES.txt +94 -0
- openrag-0.1.8/src/openrag.egg-info/dependency_links.txt +1 -0
- openrag-0.1.8/src/openrag.egg-info/entry_points.txt +2 -0
- openrag-0.1.8/src/openrag.egg-info/requires.txt +28 -0
- openrag-0.1.8/src/openrag.egg-info/top_level.txt +12 -0
- openrag-0.1.8/src/services/__init__.py +0 -0
- openrag-0.1.8/src/services/auth_service.py +369 -0
- openrag-0.1.8/src/services/chat_service.py +492 -0
- openrag-0.1.8/src/services/conversation_persistence_service.py +128 -0
- openrag-0.1.8/src/services/document_service.py +437 -0
- openrag-0.1.8/src/services/flows_service.py +110 -0
- openrag-0.1.8/src/services/knowledge_filter_service.py +321 -0
- openrag-0.1.8/src/services/langflow_file_service.py +292 -0
- openrag-0.1.8/src/services/langflow_history_service.py +172 -0
- openrag-0.1.8/src/services/monitor_service.py +305 -0
- openrag-0.1.8/src/services/search_service.py +223 -0
- openrag-0.1.8/src/services/session_ownership_service.py +95 -0
- openrag-0.1.8/src/services/task_service.py +322 -0
- openrag-0.1.8/src/session_manager.py +228 -0
- openrag-0.1.8/src/tui/__init__.py +1 -0
- openrag-0.1.8/src/tui/_assets/docker-compose-cpu.yml +111 -0
- openrag-0.1.8/src/tui/_assets/docker-compose.yml +111 -0
- openrag-0.1.8/src/tui/_assets/documents/2506.08231v1.pdf +0 -0
- openrag-0.1.8/src/tui/_assets/documents/ai-human-resources.pdf +0 -0
- openrag-0.1.8/src/tui/_assets/documents/warmup_ocr.pdf +0 -0
- openrag-0.1.8/src/tui/main.py +358 -0
- openrag-0.1.8/src/tui/managers/__init__.py +1 -0
- openrag-0.1.8/src/tui/managers/container_manager.py +766 -0
- openrag-0.1.8/src/tui/managers/docling_manager.py +403 -0
- openrag-0.1.8/src/tui/managers/env_manager.py +422 -0
- openrag-0.1.8/src/tui/screens/__init__.py +1 -0
- openrag-0.1.8/src/tui/screens/config.py +592 -0
- openrag-0.1.8/src/tui/screens/diagnostics.py +572 -0
- openrag-0.1.8/src/tui/screens/logs.py +356 -0
- openrag-0.1.8/src/tui/screens/monitor.py +858 -0
- openrag-0.1.8/src/tui/screens/welcome.py +422 -0
- openrag-0.1.8/src/tui/utils/__init__.py +1 -0
- openrag-0.1.8/src/tui/utils/clipboard.py +50 -0
- openrag-0.1.8/src/tui/utils/platform.py +209 -0
- openrag-0.1.8/src/tui/utils/validation.py +139 -0
- openrag-0.1.8/src/tui/widgets/__init__.py +3 -0
- openrag-0.1.8/src/tui/widgets/command_modal.py +218 -0
- openrag-0.1.8/src/tui/widgets/diagnostics_notification.py +40 -0
- openrag-0.1.8/src/tui/widgets/error_notification.py +40 -0
- openrag-0.1.8/src/utils/__init__.py +0 -0
- openrag-0.1.8/src/utils/document_processing.py +376 -0
- openrag-0.1.8/src/utils/gpu_detection.py +47 -0
- openrag-0.1.8/src/utils/logging_config.py +117 -0
- openrag-0.1.8/src/utils/process_pool.py +13 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
recursive-include src/tui/_assets *
|
openrag-0.1.8/PKG-INFO
ADDED
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: openrag
|
|
3
|
+
Version: 0.1.8
|
|
4
|
+
Summary: Add your description here
|
|
5
|
+
Requires-Python: >=3.13
|
|
6
|
+
Description-Content-Type: text/markdown
|
|
7
|
+
Requires-Dist: agentd>=0.2.2
|
|
8
|
+
Requires-Dist: aiofiles>=24.1.0
|
|
9
|
+
Requires-Dist: cryptography>=45.0.6
|
|
10
|
+
Requires-Dist: docling[vlm]>=2.41.0; sys_platform != "darwin"
|
|
11
|
+
Requires-Dist: docling[ocrmac,vlm]>=2.41.0; sys_platform == "darwin"
|
|
12
|
+
Requires-Dist: google-api-python-client>=2.143.0
|
|
13
|
+
Requires-Dist: google-auth-httplib2>=0.2.0
|
|
14
|
+
Requires-Dist: google-auth-oauthlib>=1.2.0
|
|
15
|
+
Requires-Dist: msal>=1.29.0
|
|
16
|
+
Requires-Dist: httpx>=0.27.0
|
|
17
|
+
Requires-Dist: opensearch-py[async]>=3.0.0
|
|
18
|
+
Requires-Dist: pyjwt>=2.8.0
|
|
19
|
+
Requires-Dist: python-multipart>=0.0.20
|
|
20
|
+
Requires-Dist: starlette>=0.47.1
|
|
21
|
+
Requires-Dist: torch>=2.7.1
|
|
22
|
+
Requires-Dist: uvicorn>=0.35.0
|
|
23
|
+
Requires-Dist: boto3>=1.35.0
|
|
24
|
+
Requires-Dist: psutil>=7.0.0
|
|
25
|
+
Requires-Dist: rich>=13.0.0
|
|
26
|
+
Requires-Dist: textual>=0.45.0
|
|
27
|
+
Requires-Dist: python-dotenv>=1.0.0
|
|
28
|
+
Requires-Dist: textual-fspicker>=0.6.0
|
|
29
|
+
Requires-Dist: structlog>=25.4.0
|
|
30
|
+
Requires-Dist: docling-serve>=1.4.1
|
|
31
|
+
|
|
32
|
+
<div align="center">
|
|
33
|
+
|
|
34
|
+
# OpenRAG
|
|
35
|
+
|
|
36
|
+
</div>
|
|
37
|
+
<div align="center">
|
|
38
|
+
<a href="#quick-start" style="color: #0366d6;">🚀 Quick Start</a> |
|
|
39
|
+
<a href="#tui-interface" style="color: #0366d6;">💻 TUI Interface</a> |
|
|
40
|
+
<a href="#docker-deployment" style="color: #0366d6;">🐳 Docker Deployment</a> |
|
|
41
|
+
<a href="#development" style="color: #0366d6;">⚙️ Development</a> |
|
|
42
|
+
<a href="#troubleshooting" style="color: #0366d6;">🔧 Troubleshooting</a>
|
|
43
|
+
</div>
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
OpenRAG is a comprehensive Retrieval-Augmented Generation platform that enables intelligent document search and AI-powered conversations. Users can upload, process, and query documents through a chat interface backed by large language models and semantic search capabilities. The system utilizes Langflow for document ingestion, retrieval workflows, and intelligent nudges, providing a seamless RAG experience. Built with Starlette, Next.js, OpenSearch, and Langflow integration. [](https://deepwiki.com/phact/openrag)
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
<div align="center">
|
|
51
|
+
<a href="https://github.com/langflow-ai/langflow"><img src="https://img.shields.io/badge/Langflow-1C1C1E?style=flat&logo=langflow" alt="Langflow"></a>
|
|
52
|
+
|
|
53
|
+
<a href="https://github.com/opensearch-project/OpenSearch"><img src="https://img.shields.io/badge/OpenSearch-005EB8?style=flat&logo=opensearch&logoColor=white" alt="OpenSearch"></a>
|
|
54
|
+
|
|
55
|
+
<a href="https://github.com/encode/starlette"><img src="https://img.shields.io/badge/Starlette-009639?style=flat&logo=fastapi&logoColor=white" alt="Starlette"></a>
|
|
56
|
+
|
|
57
|
+
<a href="https://github.com/vercel/next.js"><img src="https://img.shields.io/badge/Next.js-000000?style=flat&logo=next.js&logoColor=white" alt="Next.js"></a>
|
|
58
|
+
|
|
59
|
+
</div>
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
## 🚀 Quick Start
|
|
67
|
+
|
|
68
|
+
### Prerequisites
|
|
69
|
+
|
|
70
|
+
- Docker or Podman with Compose installed
|
|
71
|
+
- Make (for development commands)
|
|
72
|
+
|
|
73
|
+
### 1. Environment Setup
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
# Clone and setup environment
|
|
77
|
+
git clone https://github.com/langflow-ai/openrag.git
|
|
78
|
+
cd openrag
|
|
79
|
+
make setup # Creates .env and installs dependencies
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### 2. Configure Environment
|
|
83
|
+
|
|
84
|
+
Edit `.env` with your API keys and credentials:
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
# Required
|
|
88
|
+
OPENAI_API_KEY=your_openai_api_key
|
|
89
|
+
OPENSEARCH_PASSWORD=your_secure_password
|
|
90
|
+
LANGFLOW_SUPERUSER=admin
|
|
91
|
+
LANGFLOW_SUPERUSER_PASSWORD=your_secure_password
|
|
92
|
+
LANGFLOW_CHAT_FLOW_ID=your_chat_flow_id
|
|
93
|
+
LANGFLOW_INGEST_FLOW_ID=your_ingest_flow_id
|
|
94
|
+
NUDGES_FLOW_ID=your_nudges_flow_id
|
|
95
|
+
```
|
|
96
|
+
ee extended configuration, including ingestion and optional variables: [docs/configuration.md](docs/
|
|
97
|
+
configuration.md)
|
|
98
|
+
### 3. Start OpenRAG
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# Full stack with GPU support
|
|
102
|
+
make dev
|
|
103
|
+
|
|
104
|
+
# Or CPU only
|
|
105
|
+
make dev-cpu
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Access the services:
|
|
109
|
+
- **Frontend**: http://localhost:3000
|
|
110
|
+
- **Backend API**: http://localhost:8000
|
|
111
|
+
- **Langflow**: http://localhost:7860
|
|
112
|
+
- **OpenSearch**: http://localhost:9200
|
|
113
|
+
- **OpenSearch Dashboards**: http://localhost:5601
|
|
114
|
+
|
|
115
|
+
## 🖥️ TUI Interface
|
|
116
|
+
|
|
117
|
+
OpenRAG includes a powerful Terminal User Interface (TUI) for easy setup, configuration, and monitoring. The TUI provides a user-friendly way to manage your OpenRAG installation without complex command-line operations.
|
|
118
|
+
|
|
119
|
+

|
|
120
|
+
|
|
121
|
+
### Launching the TUI
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
# Install dependencies first
|
|
125
|
+
uv sync
|
|
126
|
+
|
|
127
|
+
# Launch the TUI
|
|
128
|
+
uv run openrag
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### TUI Features
|
|
132
|
+
|
|
133
|
+
See the full TUI guide for features, navigation, and benefits: [docs/tui.md](docs/tui.md)
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
|
|
137
|
+
|
|
138
|
+
## 🐳 Docker Deployment
|
|
139
|
+
|
|
140
|
+
### Standard Deployment
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
# Build and start all services
|
|
144
|
+
docker compose build
|
|
145
|
+
docker compose up -d
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
### CPU-Only Deployment
|
|
149
|
+
|
|
150
|
+
For environments without GPU support:
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
docker compose -f docker-compose-cpu.yml up -d
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
More deployment commands and tips: [docs/docker.md](docs/docker.md)
|
|
157
|
+
|
|
158
|
+
## 🔧 Troubleshooting
|
|
159
|
+
|
|
160
|
+
### Podman on macOS
|
|
161
|
+
|
|
162
|
+
If using Podman on macOS, you may need to increase VM memory:
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
podman machine stop
|
|
166
|
+
podman machine rm
|
|
167
|
+
podman machine init --memory 8192 # 8 GB example
|
|
168
|
+
podman machine start
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
### Common Issues
|
|
172
|
+
|
|
173
|
+
See common issues and fixes: [docs/troubleshooting.md](docs/troubleshooting.md)
|
|
174
|
+
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
## 🛠️ Development
|
|
178
|
+
|
|
179
|
+
For developers wanting to contribute to OpenRAG or set up a development environment, please see our comprehensive development guide:
|
|
180
|
+
|
|
181
|
+
**[📚 See CONTRIBUTING.md for detailed development instructions](CONTRIBUTING.md)**
|
|
182
|
+
|
|
183
|
+
The contributing guide includes:
|
|
184
|
+
- Complete development environment setup
|
|
185
|
+
- Local development workflows
|
|
186
|
+
- Testing and debugging procedures
|
|
187
|
+
- Code style guidelines
|
|
188
|
+
- Architecture overview
|
|
189
|
+
- Pull request guidelines
|
|
190
|
+
|
|
191
|
+
### Quick Development Commands
|
|
192
|
+
|
|
193
|
+
```bash
|
|
194
|
+
make help # See all available commands
|
|
195
|
+
make setup # Initial development setup
|
|
196
|
+
make infra # Start infrastructure services
|
|
197
|
+
make backend # Run backend locally
|
|
198
|
+
make frontend # Run frontend locally
|
|
199
|
+
```
|
openrag-0.1.8/README.md
ADDED
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# OpenRAG
|
|
4
|
+
|
|
5
|
+
</div>
|
|
6
|
+
<div align="center">
|
|
7
|
+
<a href="#quick-start" style="color: #0366d6;">🚀 Quick Start</a> |
|
|
8
|
+
<a href="#tui-interface" style="color: #0366d6;">💻 TUI Interface</a> |
|
|
9
|
+
<a href="#docker-deployment" style="color: #0366d6;">🐳 Docker Deployment</a> |
|
|
10
|
+
<a href="#development" style="color: #0366d6;">⚙️ Development</a> |
|
|
11
|
+
<a href="#troubleshooting" style="color: #0366d6;">🔧 Troubleshooting</a>
|
|
12
|
+
</div>
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
OpenRAG is a comprehensive Retrieval-Augmented Generation platform that enables intelligent document search and AI-powered conversations. Users can upload, process, and query documents through a chat interface backed by large language models and semantic search capabilities. The system utilizes Langflow for document ingestion, retrieval workflows, and intelligent nudges, providing a seamless RAG experience. Built with Starlette, Next.js, OpenSearch, and Langflow integration. [](https://deepwiki.com/phact/openrag)
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
<div align="center">
|
|
20
|
+
<a href="https://github.com/langflow-ai/langflow"><img src="https://img.shields.io/badge/Langflow-1C1C1E?style=flat&logo=langflow" alt="Langflow"></a>
|
|
21
|
+
|
|
22
|
+
<a href="https://github.com/opensearch-project/OpenSearch"><img src="https://img.shields.io/badge/OpenSearch-005EB8?style=flat&logo=opensearch&logoColor=white" alt="OpenSearch"></a>
|
|
23
|
+
|
|
24
|
+
<a href="https://github.com/encode/starlette"><img src="https://img.shields.io/badge/Starlette-009639?style=flat&logo=fastapi&logoColor=white" alt="Starlette"></a>
|
|
25
|
+
|
|
26
|
+
<a href="https://github.com/vercel/next.js"><img src="https://img.shields.io/badge/Next.js-000000?style=flat&logo=next.js&logoColor=white" alt="Next.js"></a>
|
|
27
|
+
|
|
28
|
+
</div>
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
## 🚀 Quick Start
|
|
36
|
+
|
|
37
|
+
### Prerequisites
|
|
38
|
+
|
|
39
|
+
- Docker or Podman with Compose installed
|
|
40
|
+
- Make (for development commands)
|
|
41
|
+
|
|
42
|
+
### 1. Environment Setup
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
# Clone and setup environment
|
|
46
|
+
git clone https://github.com/langflow-ai/openrag.git
|
|
47
|
+
cd openrag
|
|
48
|
+
make setup # Creates .env and installs dependencies
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### 2. Configure Environment
|
|
52
|
+
|
|
53
|
+
Edit `.env` with your API keys and credentials:
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
# Required
|
|
57
|
+
OPENAI_API_KEY=your_openai_api_key
|
|
58
|
+
OPENSEARCH_PASSWORD=your_secure_password
|
|
59
|
+
LANGFLOW_SUPERUSER=admin
|
|
60
|
+
LANGFLOW_SUPERUSER_PASSWORD=your_secure_password
|
|
61
|
+
LANGFLOW_CHAT_FLOW_ID=your_chat_flow_id
|
|
62
|
+
LANGFLOW_INGEST_FLOW_ID=your_ingest_flow_id
|
|
63
|
+
NUDGES_FLOW_ID=your_nudges_flow_id
|
|
64
|
+
```
|
|
65
|
+
ee extended configuration, including ingestion and optional variables: [docs/configuration.md](docs/
|
|
66
|
+
configuration.md)
|
|
67
|
+
### 3. Start OpenRAG
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# Full stack with GPU support
|
|
71
|
+
make dev
|
|
72
|
+
|
|
73
|
+
# Or CPU only
|
|
74
|
+
make dev-cpu
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Access the services:
|
|
78
|
+
- **Frontend**: http://localhost:3000
|
|
79
|
+
- **Backend API**: http://localhost:8000
|
|
80
|
+
- **Langflow**: http://localhost:7860
|
|
81
|
+
- **OpenSearch**: http://localhost:9200
|
|
82
|
+
- **OpenSearch Dashboards**: http://localhost:5601
|
|
83
|
+
|
|
84
|
+
## 🖥️ TUI Interface
|
|
85
|
+
|
|
86
|
+
OpenRAG includes a powerful Terminal User Interface (TUI) for easy setup, configuration, and monitoring. The TUI provides a user-friendly way to manage your OpenRAG installation without complex command-line operations.
|
|
87
|
+
|
|
88
|
+

|
|
89
|
+
|
|
90
|
+
### Launching the TUI
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
# Install dependencies first
|
|
94
|
+
uv sync
|
|
95
|
+
|
|
96
|
+
# Launch the TUI
|
|
97
|
+
uv run openrag
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### TUI Features
|
|
101
|
+
|
|
102
|
+
See the full TUI guide for features, navigation, and benefits: [docs/tui.md](docs/tui.md)
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
## 🐳 Docker Deployment
|
|
108
|
+
|
|
109
|
+
### Standard Deployment
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
# Build and start all services
|
|
113
|
+
docker compose build
|
|
114
|
+
docker compose up -d
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
### CPU-Only Deployment
|
|
118
|
+
|
|
119
|
+
For environments without GPU support:
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
docker compose -f docker-compose-cpu.yml up -d
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
More deployment commands and tips: [docs/docker.md](docs/docker.md)
|
|
126
|
+
|
|
127
|
+
## 🔧 Troubleshooting
|
|
128
|
+
|
|
129
|
+
### Podman on macOS
|
|
130
|
+
|
|
131
|
+
If using Podman on macOS, you may need to increase VM memory:
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
podman machine stop
|
|
135
|
+
podman machine rm
|
|
136
|
+
podman machine init --memory 8192 # 8 GB example
|
|
137
|
+
podman machine start
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### Common Issues
|
|
141
|
+
|
|
142
|
+
See common issues and fixes: [docs/troubleshooting.md](docs/troubleshooting.md)
|
|
143
|
+
|
|
144
|
+
|
|
145
|
+
|
|
146
|
+
## 🛠️ Development
|
|
147
|
+
|
|
148
|
+
For developers wanting to contribute to OpenRAG or set up a development environment, please see our comprehensive development guide:
|
|
149
|
+
|
|
150
|
+
**[📚 See CONTRIBUTING.md for detailed development instructions](CONTRIBUTING.md)**
|
|
151
|
+
|
|
152
|
+
The contributing guide includes:
|
|
153
|
+
- Complete development environment setup
|
|
154
|
+
- Local development workflows
|
|
155
|
+
- Testing and debugging procedures
|
|
156
|
+
- Code style guidelines
|
|
157
|
+
- Architecture overview
|
|
158
|
+
- Pull request guidelines
|
|
159
|
+
|
|
160
|
+
### Quick Development Commands
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
make help # See all available commands
|
|
164
|
+
make setup # Initial development setup
|
|
165
|
+
make infra # Start infrastructure services
|
|
166
|
+
make backend # Run backend locally
|
|
167
|
+
make frontend # Run frontend locally
|
|
168
|
+
```
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "openrag"
|
|
3
|
+
version = "0.1.8"
|
|
4
|
+
description = "Add your description here"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
requires-python = ">=3.13"
|
|
7
|
+
dependencies = [
|
|
8
|
+
"agentd>=0.2.2",
|
|
9
|
+
"aiofiles>=24.1.0",
|
|
10
|
+
"cryptography>=45.0.6",
|
|
11
|
+
"docling[vlm]>=2.41.0; sys_platform != 'darwin'",
|
|
12
|
+
"docling[ocrmac,vlm]>=2.41.0; sys_platform == 'darwin'",
|
|
13
|
+
"google-api-python-client>=2.143.0",
|
|
14
|
+
"google-auth-httplib2>=0.2.0",
|
|
15
|
+
"google-auth-oauthlib>=1.2.0",
|
|
16
|
+
"msal>=1.29.0",
|
|
17
|
+
"httpx>=0.27.0",
|
|
18
|
+
"opensearch-py[async]>=3.0.0",
|
|
19
|
+
"pyjwt>=2.8.0",
|
|
20
|
+
"python-multipart>=0.0.20",
|
|
21
|
+
"starlette>=0.47.1",
|
|
22
|
+
"torch>=2.7.1",
|
|
23
|
+
"uvicorn>=0.35.0",
|
|
24
|
+
"boto3>=1.35.0",
|
|
25
|
+
"psutil>=7.0.0",
|
|
26
|
+
"rich>=13.0.0",
|
|
27
|
+
"textual>=0.45.0",
|
|
28
|
+
"python-dotenv>=1.0.0",
|
|
29
|
+
"textual-fspicker>=0.6.0",
|
|
30
|
+
"structlog>=25.4.0",
|
|
31
|
+
"docling-serve>=1.4.1",
|
|
32
|
+
]
|
|
33
|
+
|
|
34
|
+
[project.scripts]
|
|
35
|
+
openrag = "tui.main:run_tui"
|
|
36
|
+
|
|
37
|
+
[tool.uv]
|
|
38
|
+
package = true
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
[tool.uv.sources]
|
|
42
|
+
torch = [
|
|
43
|
+
{ index = "pytorch-cu128", marker = "sys_platform == 'linux' and platform_machine == 'x86_64'" },
|
|
44
|
+
]
|
|
45
|
+
torchvision = [
|
|
46
|
+
{ index = "pytorch-cu128", marker = "sys_platform == 'linux' and platform_machine == 'x86_64'" },
|
|
47
|
+
]
|
|
48
|
+
|
|
49
|
+
[[tool.uv.index]]
|
|
50
|
+
name = "pytorch-cu128"
|
|
51
|
+
url = "https://download.pytorch.org/whl/cu128"
|
|
52
|
+
explicit = true
|
openrag-0.1.8/setup.cfg
ADDED