{"id":33123864,"url":"https://github.com/skaldlabs/skald","last_synced_at":"2026-01-28T01:39:47.036Z","repository":{"id":320936257,"uuid":"1072977097","full_name":"skaldlabs/skald","owner":"skaldlabs","description":"Context layer platform in your infrastructure","archived":false,"fork":false,"pushed_at":"2026-01-26T02:49:49.000Z","size":29843,"stargazers_count":533,"open_issues_count":24,"forks_count":36,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-26T16:55:42.111Z","etag":null,"topics":["ai","chat","javascript","knowledge-base","python","rag","self-hosted","typescript"],"latest_commit_sha":null,"homepage":"https://useskald.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/skaldlabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-09T13:15:29.000Z","updated_at":"2026-01-26T08:32:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"b5634f07-1831-4ed3-ba26-d0282e95c549","html_url":"https://github.com/skaldlabs/skald","commit_stats":null,"previous_names":["skaldlabs/skald"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/skaldlabs/skald","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skaldlabs%2Fskald","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skaldlabs%2Fskald/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skaldlabs%2Fskald/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skaldlabs%2Fskald/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skaldlabs","download_url":"https://codeload.github.com/skaldlabs/skald/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skaldlabs%2Fskald/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28832084,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T23:29:49.665Z","status":"ssl_error","status_checked_at":"2026-01-27T23:25:58.379Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chat","javascript","knowledge-base","python","rag","self-hosted","typescript"],"created_at":"2025-11-15T06:00:26.111Z","updated_at":"2026-01-28T01:39:47.031Z","avatar_url":"https://github.com/skaldlabs.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"![Skald banner](./readme-assets/skald-banner.png)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://docs.useskald.com/\"\u003eDocs\u003c/a\u003e - \u003ca href=\"https://useskald.com\"\u003eWebsite\u003c/a\u003e  - \u003ca href=\"https://www.loom.com/share/f9ac358792284d6a9bc9807e9f48587e\"\u003eDemo video\u003c/a\u003e - \u003ca href=\"https://www.loom.com/share/236148c9e8be482f95961a19d9e455ea\"\u003eSelf-hosted deploy\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pypi.org/project/skald-sdk/\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/pypi-v.0.4.1-blue\" alt=\"skald-sdk Python\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.npmjs.com/package/@skald-labs/skald-node\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/npm-v.0.4.0-blue\" alt=\"skald-node\"\u003e\n    \u003c/a\u003e\n        \u003ca href=\"https://github.com/skaldlabs/skald-go\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/go-v.0.3.0-blue\" alt=\"skald-go\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://rubygems.org/gems/skald\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/gem-v.0.1.0-blue\" alt=\"Skald Ruby\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/skald/skald-php\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/composer-v.1.0.2-blue\" alt=\"skald/skald-php\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/skaldlabs/skald-csharp\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/csharp-v.0.1.0-blue\" alt=\"skald-csharp\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/skaldlabs/skald-mcp\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/mcp-v.0.1.0-blue\" alt=\"skald-mcp\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.npmjs.com/package/@skald-labs/cli\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/cli-v.0.1.3-blue\" alt=\"skald-cli\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n# Skald: Open Source Production RAG in your infrastructure\n\nSkald 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.\n\nIn 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.\n\nOur 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.\n\nShip, configure, and evaluate performance directly inside Skald.\n\n\u003ca href=\"https://join.slack.com/t/skaldcommunity/shared_invite/zt-3he986lub-UWKTZneOAUeTFa4LDXpFEg\"\u003e\n    \u003cimg height='40' src=\"/readme-assets/join-slack.svg\" alt=\"join-slack\"\u003e\n\u003c/a\u003e\n\n## [Node SDK](https://github.com/skaldlabs/skald-node) example\n\n```js\nimport { Skald } from '@skald-labs/skald-node'\n\nconst skald = new Skald('your-api-key-here')\n\nawait skald.createMemo({\n    title: 'Meeting Notes',\n    content: 'Full content of the memo...',\n})\n\nconst chatRes = await skald.chat({\n    query: 'What were the main points discussed in the Q1 meeting?',\n    rag_config: { reranking: { enabled: true } },\n})\n\nconsole.log(chatRes.response)\n```\n\n\u003csmall\u003e[Python](https://docs.useskald.com/docs/sdks/python#usage) - [Ruby](https://docs.useskald.com/docs/sdks/ruby#usage) - [Go](https://docs.useskald.com/docs/sdks/go#usage) - [PHP](https://docs.useskald.com/docs/sdks/php#quick-start) - [C#](https://github.com/skaldlabs/skald-csharp) - [MCP](https://docs.useskald.com/docs/sdks/mcp) - [CLI](https://docs.useskald.com/docs/sdks/cli)\u003c/small\u003e\n\n## ⚡ Try it\n\n```sh\ngit clone https://github.com/skaldlabs/skald\ncd skald\necho \"OPENAI_API_KEY=\u003cyour_key\u003e\" \u003e .env\ndocker-compose up\n```\n\nFor a production self-hosted deploy, check out our [self-hosting docs](https://docs.useskald.com/docs/self-host/intro).\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\u003cb\u003eRunning Skald without \u003cu\u003eany\u003c/u\u003e third-party services\u003c/b\u003e\n\u003c/summary\u003e\n\u003cbr\u003e\n\nYou 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](https://docs.useskald.com) for more details. You can also ask us questions on [Slack](https://join.slack.com/t/skaldcommunity/shared_invite/zt-3he986lub-UWKTZneOAUeTFa4LDXpFEg).\n\n\u003c/details\u003e\n\n## ✨ Features:\n\n- **Chat:** Chat with your knowledge in Skald with just one API call\n- **Search:** Use semantic search to find relevant context based on user queries\n- **Turnkey configuration:** Get started in minutes with great defaults and then configure your RAG engine exactly how you want it.\n- **Evaluate:** Evaluate the performance of your custom RAG engine with our built-in evaluation tools.\n- **Powerful filtering:** Speed up and improve responses by filtering the accessible knowledge in every query.\n- **Amazing DX, no bullsh\\*t:** Implement in minutes with SDKs for every major language. Don't see yours? Open [an issue](https://github.com/skaldlabs/skald/issues/new) and we'll build it!\n- **Truly open source:** Our open source version is fully-featured, easy to deploy, and can even run with [no third-party dependencies](https://docs.useskald.com/docs/self-host/full-local).\n\n## 🚀 Get started\n\n- [Cloud](https://useskald.com): free tier with no credit card required\n- [Self-hosted](https://docs.useskald.com/docs/self-host/intro): get a fully-featured production deploy with SSL live in less than an hour\n\n## 🗒️ License\n\nThis repo is available under the [MIT license](https://github.com/skaldlabs/skald/blob/main/LICENSE), except for the `ee` directory (which has [its license here](https://github.com/skaldlabs/skald/blob/main/ee/LICENSE)) if applicable.\n\nIf you absolutely need 100% FOSS code, you can use the [skald-foss](https://github.com/skaldlabs/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.\n\n## 🤝 Contributing\n\nWe'd be glad to have your contributions! See [CONTRIBUTING.md](/CONTRIBUTING.md) for instructions on how to run Skald locally and how to contribute.\n\nFeel free to join our [Slack Community](https://join.slack.com/t/skaldcommunity/shared_invite/zt-3he986lub-UWKTZneOAUeTFa4LDXpFEg)\n\n## ❤️ Contributors\n\nList of people who have contributed to any of our repos.\n\n\u003cp\u003e\n    \u003ca href=\"https://github.com/yakkomajuri\"\u003e\u003cimg src=\"https://github.com/yakkomajuri.png\" width=\"60px\" alt=\"pedrique\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/pedrique\"\u003e\u003cimg src=\"https://github.com/pedrique.png\" width=\"60px\" alt=\"pedrique\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/gustavocidornelas\"\u003e\u003cimg src=\"https://github.com/gustavocidornelas.png\" width=\"60px\" alt=\"gustavocidornelas\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/viniciusgabrielfo\"\u003e\u003cimg src=\"https://github.com/viniciusgabrielfo.png\" width=\"60px\" alt=\"viniciusgabrielfo\"/\u003e\u003c/a\u003e \n    \u003ca href=\"https://github.com/Kastango\"\u003e\u003cimg src=\"https://github.com/Kastango.png\" width=\"60px\" alt=\"Kastango\"/\u003e\u003c/a\u003e \n    \u003ca href=\"https://github.com/jonchurch\"\u003e\u003cimg src=\"https://github.com/jonchurch.png\" width=\"60px\" alt=\"jonchurch\"/\u003e\u003c/a\u003e \n    \u003ca href=\"https://github.com/estebandalelr\"\u003e\u003cimg src=\"https://github.com/estebandalelr.png\" width=\"60px\" alt=\"estebandalelr\"/\u003e\u003c/a\u003e \n    \u003ca href=\"https://github.com/drainpixie\"\u003e\u003cimg src=\"https://github.com/drainpixie.png\" width=\"60px\" alt=\"drainpixie\"/\u003e\u003c/a\u003e \n    \u003ca href=\"https://github.com/yeasin2002\"\u003e\u003cimg src=\"https://github.com/yeasin2002.png\" width=\"60px\" alt=\"yeasin2002\"/\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/p-tirth\"\u003e\u003cimg src=\"https://github.com/p-tirth.png\" width=\"60px\" alt=\"p-tirth\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskaldlabs%2Fskald","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskaldlabs%2Fskald","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskaldlabs%2Fskald/lists"}