OneRAG

(★ 125)

Production-ready RAG Framework (Python/FastAPI). 1-line config swaps: 6 Vector DBs (Weaviate, Pinecone, Qdrant, ChromaDB, pgvector, MongoDB), 5 LLMs (Gemini, OpenAI, Claude, Ollama, OpenRouter). OpenAI-compatible API. 2100+ tests.

파일 탐색기

최종 버전 다운로드 (.zip)

- - onerag_harness_guard.py
  - onerag_harness_session.py
- - onerag-harness.rules
- config.toml
- - bug_report.yml
  - config.yml
  - feature_request.yml
- - ci.yml
  - live-provider-smoke.yml
  - llm-costs.yml
- dependabot.yml
- pull_request_template.md
- - __init__.py
  - admin.py
  - admin_ai_settings_store.py
  - analytics.py
  - analytics_event_store.py
  - audit_event_store.py
  - chat.py
  - container_registry.py
  - document_ledger_store.py
  - documents.py
  - evaluations.py
  - health.py
  - image_chat.py
  - ingest.py
  - langsmith_logs.py
  - monitoring.py
  - original_file_storage.py
  - prompts.py
  - upload.py
  - upload_job_store.py
- - __init__.py
  - external_crawler.py
  - metadata_chunker.py
  - notion_batch.py
  - notion_client.py
- - base.yaml
  - routing_rules_v2.yaml
  - schemas.py
  - tool_definitions.yaml
- - __init__.py
  - di_container.py
  - graceful_initializer.py
- - __init__.py
- - __init__.py
  - auth.py
  - circuit_breaker.py
  - config_loader.py
  - config_validator.py
  - env_validator.py
  - environment.py
  - langfuse_client.py
  - langsmith_client.py
  - llm_client.py
  - logger.py
  - metrics.py
  - mongodb_client.py
  - prompt_sanitizer.py
  - retry.py
  - score_normalizer.py
  - startup_policy.py
  - topic_extractor.py
  - types.py
  - weaviate_client.py
  - weaviate_setup.py
- - error_logger.py
  - rate_limiter.py
- - __init__.py
  - evaluation.py
  - prompts.py
- - __init__.py
- __init__.py
- architecture.svg
- demo-cli.svg
- logo.svg
- screenshot-admin.png
- screenshot-chat-dark.png
- screenshot-docs.png
- - extraction_prompts.json
  - prompts.json
- - product_spec.md
  - quarterly_report.txt
- - 2026-05-03-consensus-agent-harness.md
  - 2026-05-03-release-readiness-priorities.md
  - 2026-05-05-ralph-loop-execution-plan.md
  - 2026-05-06-grok-managed-rag-goal.md
  - 2026-05-10-minimal-security-verification-plan.md
  - 2026-06-25-admin-ai-settings-langfuse-tracking-plan.md
- - dependency-triage.md
- - error_message_standards.md
  - logging_standards.md
- API_REFERENCE.md
- ARCHITECTURE.md
- CODEX_HARNESS.md
- config_management_improvements.md
- DEVELOPMENT.md
- DOMAIN_GUIDE.md
- EVALUATION_SYSTEM.md
- INGESTION.md
- INTEGRATION_VERIFICATION.md
- LANGFUSE_SETUP.md
- PRODUCTION_IMPROVEMENT_ROADMAP.md
- PRODUCTION_READINESS_VERIFICATION.md
- rate-limiting-guide.md
- README.md
- SETUP.md
- STATUS.md
- streaming-api-guide.md
- SYSTEM_ANALYSIS_AND_IMPROVEMENTS.md
- TECHNICAL_DEBT_ANALYSIS.md
- tutorial.md
- websocket-api-guide.md
- - __init__.py
  - en.yaml
  - ja.yaml
  - ko.yaml
  - zh.yaml
- - system_prompt_en.txt
  - system_prompt_ja.txt
  - system_prompt_ko.txt
  - system_prompt_zh.txt
- - sample_data_en.json
  - sample_data_ja.json
  - sample_data_ko.json
  - sample_data_zh.json
- .env.example
- __init__.py
- chat.py
- load_data.py
- run.py
- - BRAND_CONFIGURATION_GUIDE.md
  - BUILD_OPTIMIZATION_RECOMMENDATIONS.md
  - CHAT_EMPTY_STATE_SETTINGS.md
  - CHATTAB_REFACTORING_PLAN.md
  - claude-withcodex-setup.md
  - COLOR_SYSTEM_GUIDE.md
  - CUSTOMIZATION_GUIDE.md
  - DEPLOY_NOW.md
  - FEATURE_FLAGS_GUIDE.md
  - HARDCODING_IMPROVEMENTS.md
  - IMPLEMENTATION_SUMMARY.md
  - IMPROVEMENTS_2025.md
  - LOCALHOST_ISSUE_FIXED.md
  - PERFORMANCE_OPTIMIZATIONS.md
  - PHONE_MASKING_GUIDE.md
  - RAILWAY_DEPLOYMENT_GUIDE.md
  - RAILWAY_ENV_SETUP.md
  - RAILWAY_SETUP.md
  - SYSTEM_IMPROVEMENTS_2025.md
  - WEBSOCKET_DI_GUIDE.md
- - websocket-chat.spec.ts
- - _redirects
  - chatbot.svg
  - config.js
  - onerag-embed.js
  - vite.svg
- - fail-on-warning-output.mjs
- - App.tsx
  - index.css
  - main.tsx
  - vite-env.d.ts
- .dockerignore
- .env.example
- .gitignore
- .nvmrc
- check-env.js
- CLAUDE.md
- components.json
- Dockerfile
- entrypoint.sh
- eslint.config.js
- generate-config.js
- index.html
- nginx.conf
- nixpacks.toml
- package-lock.json
- package.json
- playwright.config.ts
- postcss.config.cjs
- railway.toml
- README.md
- tailwind.config.cjs
- tsconfig.app.json
- tsconfig.json
- tsconfig.node.json
- vite.config.ts
- vitest.config.ts
- continuation.md
- frontend-warning-gate.md
- local-frontend-quality-gate.md
- source-citation-contract.md
- 01_quickstart.ipynb
- 02_api_exploration.ipynb
- 03_evaluation_demo.ipynb
- README.md
- .env.quickstart
- load_sample_data.py
- sample_data.json
- - 001_create_prompts_table.sql
  - 002_create_batch_tables.sql
  - 002_create_notion_metadata_collection.py
  - 003_add_running_status.sql
  - 003_insert_initial_parsing_rules.sql
  - BATCH_SYSTEM_SETUP.md
  - README.md
- backup_weaviate.py
- chat_concurrency_smoke.py
- check_weaviate.py
- check_weaviate_duplicates.py
- check_weaviate_schema.py
- create_prompts_table.py
- create_tables_railway.py
- deploy-railway.sh
- e2e_rag_smoke.py
- index_all_data.py
- production_corpus_e2e.py
- quick_analyze.py
- README.md
- reindex_documents.py
- run_eval.py
- run_migration_003.py
- search_weaviate.py
- setup-langfuse-env.sh
- setup_batch_tables.py
- start-langfuse.sh
- stop-langfuse.sh
- upload_size_smoke.py
- verify-integration.sh
- - test_data_consistency.py
  - test_evaluation_system.py
  - test_graphrag_e2e.py
  - test_hybrid_search_auto.py
  - test_hybrid_search_integration.py
  - test_ingestion_flow.py
  - test_memory_leak_prevention.py
  - test_neo4j_integration.py
  - test_operational_performance_acceptance.py
  - test_operational_stability.py
  - test_scoring_integration.py
  - test_self_reflection_e2e.py
  - test_self_reflection_real_llm.py
  - test_session_race_condition.py
  - test_streaming_e2e.py
  - test_web_search_e2e.py
  - test_websocket_e2e.py
- - __init__.py
  - test_auth_security.py
  - test_config_validator.py
  - test_environment.py
  - test_retry_policy.py
- - __init__.py
  - test_local_upload_flow.py
- - __init__.py
  - test_compose_healthcheck_contract.py
  - test_grok_retriever.py
  - test_llm_client_generation_instrumentation.py
  - test_makefile_frontend_contract.py
  - test_modules_dict_resolve_timeout.py
  - test_ollama_embedder.py
  - test_ollama_llm_client.py
- __init__.py
- conftest.py
- test_main_startup.py
.dockerignore
.env.example
.gitignore
.importlinter
.pre-commit-config.yaml
.python-version
AGENTS.md
CHANGELOG.md
CLAUDE.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
demo_main.py
docker-compose.langfuse.yml
docker-compose.neo4j.yml
docker-compose.prod.yml
docker-compose.verify.yml
docker-compose.weaviate.yml
docker-compose.yml
docker-entrypoint.sh
Dockerfile
Dockerfile.demo
LICENSE
main.py
Makefile
OpenSource.md
PRIORITY_MATRIX.md
PRIORITY_ROADMAP.md
pyproject.toml
railway.json
railway.toml
README.md
README_EN.md
SECURITY.md
SUPPORT.md
uv.lock

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/notadev-iamaura/OneRAG

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd OneRAG

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker compose -f docker-compose.langfuse.yml up -d --build

compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

cd frontend

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

4. Python

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install .

PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.

python main.py

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

5. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make start # → http://localhost:8000/docs