<a href="https://docs.useskald.com/">Docs</a> - <a href="https://useskald.com">Website</a> - <a href="https://www.loom.com/share/f9ac358792284d6a9bc9807e9f48587e">Demo video</a> - <a href="https://www.loom.com/share/236148c9e8be482f95961a19d9e455ea">Self-hosted deploy</a> <a href="https://pypi.org/project/skald-sdk/"> <img src="https://img.shields.io/badge/pypi-v.0.4.1-blue" alt="skald-sdk Python"> </a> <a href="https://www.npmjs.com/package/@skald-labs/skald-node"> <img src="https://img.shields.io/badge/npm-v.0.4.0-blue" alt="skald-node"> </a> <a href="https://github.com/skaldlabs/skald-go"> <img src="https://img.shields.io/badge/go-v.0.3.0-blue" alt="skald-go"> </a> <a href="https://rubygems.org/gems/skald"> <img src="https://img.shields.io/badge/gem-v.0.1.0-blue" alt="Skald Ruby"> </a> <a href="https://packagist.org/packages/skald/skald-php"> <img src="https://img.shields.io/badge/composer-v.1.0.2-blue" alt="skald/skald-php"> </a> <a href="https://github.com/skaldlabs/skald-csharp"> <img src="https://img.shields.io/badge/csharp-v.0.1.0-blue" alt="skald-csharp"> </a> <a href="https://github.com/skaldlabs/skald-mcp"> <img src="https://img.shields.io/badge/mcp-v.0.1.0-blue" alt="skald-mcp"> </a> <a href="https://www.npmjs.com/package/@skald-labs/cli"> <img src="https://img.shields.io/badge/cli-v.0.1.3-blue" alt="skald-cli"> </a>

Skald: Open Source Production RAG in your infrastructure

Skald gives you a production-ready RAG in minutes through a plug-and-play API, and then let's you configure your RAG engine exactly to your needs.

In the ingestion phase, Skald takes care of document parsing, chunking strategy, summaries, tagging, embedding generation, and vector storage. In the retrieval phase, it handles query rewriting, vector search, LLM chat, chat history, and source references.

Our solid defaults will work for most use cases, but you can tune every part of your RAG to better suit your needs. That means configurable vector search params, reranking, models, query rewriting, chunking (soon), and more.

Ship, configure, and evaluate performance directly inside Skald.

Node SDK example

import { Skald } from '@skald-labs/skald-node'

const skald = new Skald('your-api-key-here')

await skald.createMemo({
    title: 'Meeting Notes',
    content: 'Full content of the memo...',
})

const chatRes = await skald.chat({
    query: 'What were the main points discussed in the Q1 meeting?',
    rag_config: { reranking: { enabled: true } },
})

console.log(chatRes.response)

Python - Ruby - Go - PHP - C# - MCP - CLI

⚡ Try it

git clone https://github.com/skaldlabs/skald
cd skald
echo "OPENAI_API_KEY=<your_key>" > .env
docker-compose up

For a production self-hosted deploy, check out our self-hosting docs.

<details> <summary> Running Skald without any third-party services </summary>

You can deploy Skald without any third-party dependencies (including OpenAI), but that will require hosting your own LLM inference server and using a local embeddings service (we've provided one for you in the local docker compose profile). This is advanced usage and you should check out our docs for more details. You can also ask us questions on Slack.

</details>

✨ Features:

Chat: Chat with your knowledge in Skald with just one API call
Search: Use semantic search to find relevant context based on user queries
Turnkey configuration: Get started in minutes with great defaults and then configure your RAG engine exactly how you want it.
Evaluate: Evaluate the performance of your custom RAG engine with our built-in evaluation tools.
Powerful filtering: Speed up and improve responses by filtering the accessible knowledge in every query.
Amazing DX, no bullsh*t: Implement in minutes with SDKs for every major language. Don't see yours? Open an issue and we'll build it!
Truly open source: Our open source version is fully-featured, easy to deploy, and can even run with no third-party dependencies.

🚀 Get started

Cloud: free tier with no credit card required
Self-hosted: get a fully-featured production deploy with SSL live in less than an hour

🗒️ License

This repo is available under the MIT license, except for the ee directory (which has its license here) if applicable.

If you absolutely need 100% FOSS code, you can use the skald-foss repository, which contains all the code from this repo with the ee directory removed. It is fully-featured and as of today we actually run skald-foss on our Cloud offering. Our Enterprise Edition today is meant for on-prem deployments.

🤝 Contributing

We'd be glad to have your contributions! See CONTRIBUTING.md for instructions on how to run Skald locally and how to contribute.

Feel free to join our Slack Community

❤️ Contributors

List of people who have contributed to any of our repos.

Skald

Install / Use

README