Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Canner/WrenAI

🚀 Open-source SQL AI Agent for Text-to-SQL. Supporting PostgreSQL, DuckDB, MySQL, MS SQL, ClickHouse, Trino, JSON, CSV, Parquet data sources, and more! 🚀
https://github.com/Canner/WrenAI

agent ai bigquery duckdb fastapi gpt hacktoberfest llm nextjs nlp openai postgresql python rag sql sqlai text-to-sql text2sql typescript

Last synced: 17 days ago
JSON representation

🚀 Open-source SQL AI Agent for Text-to-SQL. Supporting PostgreSQL, DuckDB, MySQL, MS SQL, ClickHouse, Trino, JSON, CSV, Parquet data sources, and more! 🚀

Awesome Lists containing this project

README 

        





  

    

      

      

    

    
Wren AI


  






  

    

  

  

    

  

  

    

  

  

    

  

  

    

  




> Wren AI is an **open-source SQL AI Agent** that empowers data, product, and business teams to access insights through chat, built-in well designed intuitive UI and UX, integrating seamlessly with tools like Excel and Google Sheets.





  




## 🕶 Try it yourself!



https://github.com/user-attachments/assets/737bbf1f-f9f0-483b-afb3-2c622c9b91ba



👉 Try with your data on [Wren AI Cloud](https://getwren.ai/?utm_source=github&utm_medium=content&utm_campaign=readme) or [Install in your local environment](https://docs.getwren.ai/oss/installation/?utm_source=github&utm_medium=content&utm_campaign=readme)



## 🎯 Our Vision & Mission



Wren AI’s mission is to democratize data by bringing AI agents with SQL ability to any data source.



🤩 [Learn more about Wren AI and our Mission](https://docs.getwren.ai/oss/overview/introduction/?utm_source=github&utm_medium=content&utm_campaign=readme)



## 🤖 A User-Centric, End-to-End Open-source SQL AI Agent - Text-to-SQL Total Solution



### 1. Talk to Your Data in Any Language



> Wren AI speaks [your language](https://docs.getwren.ai/oss/guide/settings/pj_settings#change-project-language?utm_source=github&utm_medium=content&utm_campaign=readme), such as English, German, Spanish, French, Japanese, Korean, Portuguese, Chinese, and more. Unlock valuable insights by asking your business questions to Wren AI. It goes beyond surface-level data analysis to reveal meaningful information and simplifies obtaining answers from lead scoring templates to customer segmentation.





  




### 2. Semantic Indexing with a Well-Crafted UI/UX



> Wren AI has implemented a [semantic engine architecture](https://www.getwren.ai/post/how-we-design-our-semantic-engine-for-llms-the-backbone-of-the-semantic-layer-for-llm-architecture/?utm_source=github&utm_medium=content&utm_campaign=readme) to provide the LLM context of your business; you can easily establish a logical presentation layer on your data schema that helps LLM learn more about your business context.





  




### 3. Generate SQL Queries with Context



> With Wren AI, you can process metadata, schema, terminology, data relationships, and the logic behind calculations and aggregations with [“Modeling Definition Language”](https://docs.getwren.ai/oss/engine/concept/what_is_mdl/?utm_source=github&utm_medium=content&utm_campaign=readme), reducing duplicate coding and simplifying data joins.





  




### 4. Get Insights without Writing Code



> When starting a new conversation in Wren AI, your question is used to find the most relevant tables. From these, LLM generates the most relevant question for the user. You can also ask follow-up questions to get deeper insights.





  




### 5. Easily Export and Visualize Your Data



> Wren AI provides a seamless end-to-end workflow, enabling you to connect your data effortlessly with popular analysis tools such as [Excel](https://docs.getwren.ai/oss/guide/integrations/excel-add-in/?utm_source=github&utm_medium=content&utm_campaign=readme) and [Google Sheets](https://docs.getwren.ai/oss/guide/integrations/google-add-on/?utm_source=github&utm_medium=content&utm_campaign=readme). This way, your insights remain accessible, allowing for further analysis using the tools you know best.





  




## 🤔 Why Wren AI?



We focus on providing an open, secure, and accurate SQL AI Agent for everyone.



### 1. Turnkey Solution



> Wren AI makes it easy to onboard your data. Discover and analyze your data with our user interface. Effortlessly generate results without needing to code.



### 2. Personalized answers without exposing data to LLM



> Your sensitive information remains protected, with no risk of being trained to public LLMs, giving you secure, personalized insights while maintaining full control of your data.



### 3. Open-source End-to-end Solution



> Deploy Wren AI anywhere you like on your own data, LLM APIs, and environment, it's free.



## 🤖 Wren AI Text-to-SQL Agentic Architecture



Wren AI consists of three core services:



- ***[Wren UI](https://github.com/Canner/WrenAI/tree/main/wren-ui):*** An intuitive user interface for asking questions, defining data relationships, and integrating data sources.



- ***[Wren AI Service](https://github.com/Canner/WrenAI/tree/main/wren-ai-service):*** Processes queries using a vector database for context retrieval, guiding LLMs to produce precise SQL outputs.



- ***[Wren Engine](https://github.com/Canner/wren-engine):*** Serves as the semantic engine, mapping business terms to data sources, defining relationships, and incorporating predefined calculations and aggregations.





  




## ❤️ Knowledge Sharing From Wren AI



Want to get our latest sharing? [Follow our blog!](https://www.getwren.ai/blog/?utm_source=github&utm_medium=content&utm_campaign=readme)



## 🚀 Getting Started



Using Wren AI is super simple, you can set it up within 3 minutes, and start to interact with your data!



- Visit our [Installation Guide of Wren AI](http://docs.getwren.ai/oss/installation).

- Visit the [Usage Guides](https://docs.getwren.ai/oss/guide/connect/overview) to learn more about how to use Wren AI.



## 📚 Documentation



Visit [Wren AI documentation](https://docs.getwren.ai/oss/overview/introduction) to view the full documentation.



## 🛠️ Contribution



Want to contribute to Wren AI? Check out our [Contribution Guidelines](https://github.com/Canner/WrenAI/blob/main/CONTRIBUTING.md).



## ⭐️ Community



- Welcome to our [Discord server](https://discord.gg/5DvshJqG8Z) to give us feedback!

- If there are any issues, please visit [GitHub Issues](https://github.com/Canner/WrenAI/issues).

- Explore our [public roadmap](https://github.com/orgs/Canner/projects/12/views/1) to stay updated on upcoming features and improvements!



Please note that our [Code of Conduct](./CODE_OF_CONDUCT.md) applies to all Wren AI community channels. Users are **highly encouraged** to read and adhere to them to avoid repercussions.



## 🎉 Our Contributors



  






  ⬆️ Back to Top