{"data":{"slug":"run-llama-rags","name":"rags","tagline":"Build ChatGPT over your data with natural language","github_url":"https://github.com/run-llama/rags","owner":"run-llama","repo":"rags","owner_avatar_url":"https://avatars.githubusercontent.com/u/130722866?v=4","primary_language":"Python","stars":6549,"forks":656,"topics":["agent","chatbot","chatgpt","gpts","llamaindex","llm","openai","rag","streamlit"],"archived":false,"github_pushed_at":"2024-04-05T05:36:59+00:00","maintenance_label":"Dormant","stars_delta_30d":6,"url":"https://www.graphcanon.com/tools/run-llama-rags","markdown_url":"https://www.graphcanon.com/tools/run-llama-rags.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/run-llama-rags","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=run-llama-rags","description":"Build ChatGPT over your data, all with natural language","homepage_url":null,"license":"MIT","open_issues":37,"watchers":54,"ai_summary":"A framework for building conversational agents that leverage user data using natural language queries and OpenAI services.","readme_excerpt":"## Installation and Setup \n\nClone this project, go into the `rags` project folder. We recommend creating a virtual env for dependencies (`python3 -m venv .venv`).\n\n```\npoetry install --with dev\n```\n\nBy default, we use OpenAI for both the builder agent as well as the generated RAG agent.\nAdd `.streamlit/secrets.toml` in the home folder.\n\nThen put the following:\n```\nopenai_key = \"<openai_key>\"\n```\n\n\nThen run the app from the \"home page\" file.\n\n```\n\nstreamlit run 1_🏠_Home.py\n\n```\n\n**NOTE**: If you've upgraded the version of RAGs, and you're running into issues on launch, you may need to delete the `cache` folder in your home directory (we may have introduced breaking changes in the stored data structure between versions).","github_created_at":"2023-11-16T07:49:44+00:00","created_at":"2026-07-07T17:37:35.253309+00:00","updated_at":"2026-08-18T12:01:29.362273+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"data-retrieval","name":"Data & Retrieval","url":"https://www.graphcanon.com/categories/data-retrieval","markdown_url":"https://www.graphcanon.com/categories/data-retrieval.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/data-retrieval"}],"tags":[{"slug":"agent","name":"agent"},{"slug":"chatbot","name":"chatbot"},{"slug":"chatgpt","name":"chatgpt"},{"slug":"llm","name":"llm"},{"slug":"openai","name":"openai"},{"slug":"rag","name":"rag"},{"slug":"streamlit","name":"streamlit"}],"trust":{"provenance":{"is_fork":false,"github_id":719455172,"owner_type":"Organization","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-08-18T12:01:28.593Z","maintenance":{"label":"Dormant","score":18,"methodology":"github_public_v1","releases_90d":0,"days_since_push":865,"last_release_at":null,"stars_delta_30d":6,"open_issues_delta_30d":-1},"security_summary":{"status":"findings","scanner":"osv@v1","low_count":38,"high_count":0,"last_scan_at":"2026-07-11T11:09:53.917Z","medium_count":0,"scan_profile":"deps","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-08-18T12:01:29.045Z"},"languages":{"value":["python"],"source":"github.language+pyproject.toml","observed_at":"2026-08-18T12:01:29.045Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-08-18T12:01:29.045Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":{"notes":["Installation leverages poetry for dependency management.","Setup requires configuration with OpenAI key and potentially creating a virtual environment."],"requires_docker":false},"constraints":{"requires_docker":false},"when_to_use":["When leveraging natural language queries over proprietary user data using OpenAI services.","If you require a framework that integrates seamlessly with Streamlit to build conversational agents.","For projects aiming to customize and extend ChatGPT capabilities over specific datasets."],"when_not_to_use":["Not suitable if you seek solutions not dependent on OpenAI's services as the underlying framework is tightly coupled with OpenAI APIs.","Avoid using rags if your project involves sensitive or highly confidential data since it requires integrating API keys, potentially posing security concerns.","If your team does not have familiarity or access to Streamlit for app development, you might find setting up and deploying a conversational agent more challenging."],"source":"enrich:decision_facts","observed_at":"2026-07-12T13:23:36.018Z"},"constraint_facets":{"requires_docker":false},"decision_summary":[{"label":"Requirements","value":"Installation leverages poetry for dependency management.; Setup requires configuration with OpenAI key and potentially creating a virtual environment."},{"label":"Adopt for","value":"Decision-critical facts for 'rags':"},{"label":"License detail","value":"MIT License"}]}}