MCPcopy
hub / github.com/onyx-dot-app/onyx

github.com/onyx-dot-app/onyx @nightly-latest-20251125.3 sqlite

repository ↗ · DeepWiki ↗ · release nightly-latest-20251125.3 ↗
12,849 symbols 61,638 edges 2,464 files 3,216 documented · 25%
README

Open Source AI Platform

<a href="https://discord.gg/TDJ59cGV2X" target="_blank">
    <img src="https://img.shields.io/badge/discord-join-blue.svg?logo=discord&logoColor=white" alt="Discord" />
</a>
<a href="https://docs.onyx.app/?utm_source=onyx_repo&utm_medium=github&utm_campaign=readme" target="_blank">
    <img src="https://img.shields.io/badge/docs-view-blue" alt="Documentation" />
</a>
<a href="https://www.onyx.app/?utm_source=onyx_repo&utm_medium=github&utm_campaign=readme" target="_blank">
    <img src="https://img.shields.io/website?url=https://www.onyx.app&up_message=visit&up_color=blue" alt="Documentation" />
</a>
<a href="https://github.com/onyx-dot-app/onyx/blob/main/LICENSE" target="_blank">
    <img src="https://img.shields.io/static/v1?label=license&message=MIT&color=blue" alt="License" />
</a>

onyx-dot-app/onyx | Trendshift

Onyx is a feature-rich, self-hostable Chat UI that works with any LLM. It is easy to deploy and can run in a completely airgapped environment.

Onyx comes loaded with advanced features like Agents, Web Search, RAG, MCP, Deep Research, Connectors to 40+ knowledge sources, and more.

[!TIP] Run Onyx with one command (or see deployment section below): curl -fsSL https://raw.githubusercontent.com/onyx-dot-app/onyx/main/deployment/docker_compose/install.sh > install.sh && chmod +x install.sh && ./install.sh


Onyx Chat Silent Demo

⭐ Features

  • 🤖 Custom Agents: Build AI Agents with unique instructions, knowledge and actions.
  • 🌍 Web Search: Browse the web with Google PSE, Exa, and Serper as well as an in-house scraper or Firecrawl.
  • 🔍 RAG: Best in class hybrid-search + knowledge graph for uploaded files and ingested documents from connectors.
  • 🔄 Connectors: Pull knowledge, metadata, and access information from over 40 applications.
  • 🔬 Deep Research: Get in depth answers with an agentic multi-step search.
  • ▶️ Actions & MCP: Give AI Agents the ability to interact with external systems.
  • 💻 Code Interpreter: Execute code to analyze data, render graphs and create files.
  • 🎨 Image Generation: Generate images based on user prompts.
  • 👥 Collaboration: Chat sharing, feedback gathering, user management, usage analytics, and more.

Onyx works with all LLMs (like OpenAI, Anthropic, Gemini, etc.) and self-hosted LLMs (like Ollama, vLLM, etc.)

To learn more about the features, check out our documentation!

🚀 Deployment

Onyx supports deployments in Docker, Kubernetes, Terraform, along with guides for major cloud providers.

See guides below: - Docker or Quickstart (best for most users) - Kubernetes (best for large teams) - Terraform (best for teams already using Terraform) - Cloud specific guides (best if specifically using AWS EKS, Azure VMs, etc.)

[!TIP]
To try Onyx for free without deploying, check out Onyx Cloud.

🔍 Other Notable Benefits

Onyx is built for teams of all sizes, from individual users to the largest global enterprises.

  • Enterprise Search: far more than simple RAG, Onyx has custom indexing and retrieval that remains performant and accurate for scales of up to tens of millions of documents.
  • Security: SSO (OIDC/SAML/OAuth2), RBAC, encryption of credentials, etc.
  • Management UI: different user roles such as basic, curator, and admin.
  • Document Permissioning: mirrors user access from external apps for RAG use cases.

🚧 Roadmap

To see ongoing and upcoming projects, check out our roadmap!

📚 Licensing

There are two editions of Onyx:

  • Onyx Community Edition (CE) is available freely under the MIT license.
  • Onyx Enterprise Edition (EE) includes extra features that are primarily useful for larger organizations. For feature details, check out our website.

👪 Community

Join our open source community on Discord!

💡 Contributing

Looking to contribute? Please check out the Contribution Guide for more details.

Extension points exported contracts — how you extend this code

ModalContextValue (Interface)
* Modal Context for managing close button ref and warning state
web/src/refresh-components/Modal.tsx
AllProvidersProps (Interface)
* Custom render function that wraps components with common providers * used throughout the Onyx application.
web/tests/setup/test-utils.tsx
FaviconFetchOptions (Interface)
(no doc)
web/@types/favicon-fetch.d.ts
ModalContentProps (Interface)
* Modal Content Component * * Main modal container with default styling. Size and other styles controlled via classNam
web/src/refresh-components/Modal.tsx
CustomRenderOptions (Interface)
(no doc)
web/tests/setup/test-utils.tsx
ModalHeaderProps (Interface)
* Modal Header Component * * Container for header content with optional bottom shadow. * Use with Modal.Icon, Modal.T
web/src/refresh-components/Modal.tsx
UserContextType (Interface)
(no doc)
web/tests/setup/mocks/components/UserProvider.tsx
ModalIconProps (Interface)
* Modal Icon Component * * Icon component for modal header. * * @example * ```tsx * <Modal.Icon icon={SvgWarning}
web/src/refresh-components/Modal.tsx

Core symbols most depended-on inside this repo

get
called by 1174
backend/onyx/connectors/gitbook/connector.py
append
called by 1073
backend/tests/regression/search_quality/utils.py
get
called by 937
backend/onyx/httpx/httpx_pool.py
error
called by 648
backend/onyx/tracing/framework/spans.py
execute
called by 562
backend/tests/unit/onyx/chat/turn/utils.py
filter
called by 504
backend/onyx/utils/logger.py
set
called by 474
web/src/lib/hooks.ts
setup_logger
called by 435
backend/onyx/utils/logger.py

Shape

Function 7,398
Method 2,547
Class 1,571
Interface 730
Route 571
Enum 32

Languages

Python75%
TypeScript25%

Modules by API surface

backend/onyx/db/models.py140 symbols
web/src/components/icons/icons.tsx136 symbols
backend/onyx/server/documents/connector.py77 symbols
backend/tests/unit/onyx/chat/turn/utils.py66 symbols
backend/onyx/auth/users.py65 symbols
web/src/lib/connectors/connectors.tsx60 symbols
backend/onyx/server/features/mcp/api.py60 symbols
backend/tests/integration/tests/pruning/website/js/jquery.js59 symbols
backend/onyx/server/manage/users.py59 symbols
web/src/lib/connectors/credentials.ts55 symbols
backend/onyx/db/document.py54 symbols
web/src/lib/types.ts53 symbols

Dependencies from manifests, versioned

@dnd-kit/core6.1.0 · 1×
@dnd-kit/modifiers7.0.0 · 1×
@dnd-kit/sortable8.0.0 · 1×
@dnd-kit/utilities3.2.2 · 1×
@emotion/stylis0.8.5 · 1×
@headlessui/react2.2.0 · 1×
@headlessui/tailwindcss0.2.1 · 1×
@onyx/opal./lib/opal · 1×
@phosphor-icons/react2.0.8 · 1×
@playwright/test1.39.0 · 1×
@radix-ui/react-accordion1.2.2 · 1×

Datastores touched

controlDatabase · 1 repos

For agents

$ claude mcp add onyx \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact