Asish Karthikeya Gogineni commited on
Commit
b07b8c4
·
1 Parent(s): 5b89d45

Refactor: Removed all Sage branding and assets

Browse files
Files changed (6) hide show
  1. CODE_OF_CONDUCT.md +1 -1
  2. CONTRIBUTING.md +6 -11
  3. MANIFEST.in +3 -3
  4. README.md +60 -58
  5. assets/storia-logo.png +0 -0
  6. setup.py +12 -1
CODE_OF_CONDUCT.md CHANGED
@@ -60,7 +60,7 @@ representative at an online or offline event.
60
 
61
  Instances of abusive, harassing, or otherwise unacceptable behavior may be
62
  reported to the community leaders responsible for enforcement at
63
- founders@storia.ai.
64
  All complaints will be reviewed and investigated promptly and fairly.
65
 
66
  All community leaders are obligated to respect the privacy and security of the
 
60
 
61
  Instances of abusive, harassing, or otherwise unacceptable behavior may be
62
  reported to the community leaders responsible for enforcement at
63
+ reported to the community leaders responsible for enforcement.
64
  All complaints will be reviewed and investigated promptly and fairly.
65
 
66
  All community leaders are obligated to respect the privacy and security of the
CONTRIBUTING.md CHANGED
@@ -1,18 +1,13 @@
1
- # Contributing to Sage
2
- Thank you for considering contributing to Sage! We welcome all kinds of contributions. You don't need to be an AI expert to have meaningful impact. If you have any questions, reach out to us via [Discord](https://discord.gg/zbtZe7GcVU).
3
-
4
- If you are looking for an internship or full-time job, becoming a contributor is the best way to surface to the top of our resume stack!
5
 
6
  ## Ways to contribute
7
  We welcome your help in multiple directions. Feel free to pick the one that best matches your skills and interest:
8
 
9
- - **Improving documentation**. All our documentation is currently in the project [README](README.md). If you find the instructions incomplete, unclear or confusing, let us know via [Discord](https://discord.gg/zbtZe7GcVU), submit an issue, or send a PR with improved verbiage.
10
- - **Simplifying the setup**. All setup instructions are documented in the [README](README.md). Currently, setting up the environment is more cumbersome than we'd like. For instance, the local setup requires installing Docker and [Marqo](https://www.marqo.ai/), while the remote setup requires you to create accounts with various providers like [Pinecone](https://www.pinecone.io/). We welcome suggestions for streamlining it.
11
- - **Plumbing tasks**. Under the "issues" tab, you will find feature requests marked with difficulty tags between 1 and 5. As a rule of thumb, difficulty labels 1-2 refer to easy coding tasks that don't require any knowledge of AI. They are meant to improve the engineering pipeline without affecting the quality of code retrieval or chat responses.
12
- - **AI quality improvements**. For contributors familiar with AI, these are the most fun feature requests, marked with difficulty 3-5: they encourage you to experiment with state-of-the art techniques for code retrieval and text generation. We welcome code contributions but also suggestions for relevant papers we should check out.
13
- - **Evaluation**. We are currently using our own benchmark for retrieval (more details [here](benchmarks/retrieval/README.md)), but we welcome suggestions for additional datasets, evaluation metrics or evaluation pipelines.
14
- - **UI/UX**. The chat experience is surfaced via a barebones Gradio app. We want to hear your suggestions for more practical or prettier form factors.
15
- - **Branding and marketing**. If you have suggestions for better imagery (logos / header image), messaging or social media presence, we're all ears!
16
 
17
  ### Code contributions
18
  For code contributions in particular, we suggest the following workflow:
 
1
+ # Contributing to Codebase Agent
2
+ Thank you for considering contributing to Codebase Agent! We welcome all kinds of contributions.
 
 
3
 
4
  ## Ways to contribute
5
  We welcome your help in multiple directions. Feel free to pick the one that best matches your skills and interest:
6
 
7
+ - **Improving documentation**. All our documentation is currently in the project [README](README.md).
8
+ - **Simplifying the setup**. All setup instructions are documented in the [README](README.md).
9
+ - **Features**. Check the issues tab or propose new features!
10
+ - **UI/UX**. The chat experience is via Streamlit. Suggestions for improvements are welcome.
 
 
 
11
 
12
  ### Code contributions
13
  For code contributions in particular, we suggest the following workflow:
MANIFEST.in CHANGED
@@ -1,3 +1,3 @@
1
- include sage/sample-exclude.txt
2
- include sage/configs/local.yaml
3
- include sage/configs/remote.yaml
 
1
+ include code_chatbot/prompts.py
2
+ include rate_limit_config.py
3
+ include requirements.txt
README.md CHANGED
@@ -1,58 +1,60 @@
1
- <div align="center">
2
- <a name="readme-top"></a>
3
- <img src="assets/storia-logo.png" alt="Logo" width="50" style="border-radius: 15px;">
4
- <h1 align="center">Sage: Chat with any codebase</h1>
5
- <div>
6
- <a href="https://discord.gg/zbtZe7GcVU" target=="_blank"><img alt="Discord" src="https://img.shields.io/discord/1286056351264407643?logo=discord&label=discord&link=https%3A%2F%2Fdiscord.gg%2FzbtZe7GcVU"></a>
7
- <a href="https://x.com/StoriaAI" target=="_blank"><img alt="X (formerly Twitter) Follow" src="https://img.shields.io/twitter/follow/Storia-AI?logo=x&link=https%3A%2F%2Fx.com%2FStoriaAI"></a>
8
- <a href="https://github.com/Storia-AI/sage/stargazers" target=="_blank"><img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/Storia-AI/sage?logo=github&link=https%3A%2F%2Fgithub.com%2FStoria-AI%2Fsage%2Fstargazers"></a>
9
- <a href="https://github.com/Storia-AI/sage/blob/main/LICENSE" target=="_blank"><img alt="GitHub License" src="https://img.shields.io/github/license/Storia-AI/sage" /></a>
10
- </div>
11
- <div>
12
- <a href="https://sage-docs.storia.ai">Documentation</a>
13
- <span>&#183;</span>
14
- <a href="https://sage.storia.ai">Hosted app</a>
15
- </div>
16
- <br />
17
- <figure>
18
- <!-- The <kbd> and <sub> tags are work-arounds for styling, since GitHub doesn't take into account inline styles. Note it might display awkwardly on other Markdown editors. -->
19
- <kbd><img src="assets/chat_screenshot2.png" alt="screenshot" /></kbd>
20
- <sub><figcaption align="center">Our chat window, showing a conversation with the Transformers library. 🚀</sub></figcaption>
21
- </figure>
22
- </div>
23
-
24
- ***
25
-
26
- **Sage** is like an open-source GitHub Copilot that helps you learn how a codebase works and how to integrate it into your project without spending hours sifting through the code.
27
-
28
- # Main features
29
- - **Dead-simple setup**. Follow our [quickstart guide](https://sage-docs.storia.ai/quickstart) to get started.
30
- - **Runs locally or on the cloud**. When privacy is your priority, you can run the entire pipeline locally using [Ollama](https://ollama.com) for LLMs and [Marqo](https://github.com/marqo-ai/marqo) as a vector store. When optimizing for quality, you can use third-party LLM providers like OpenAI and Anthropic.
31
- - **Wide range of built-in retrieval mechanisms**. We support both lightweight retrieval strategies (with nothing more but an LLM API key required) and more traditional RAG (which requires indexing the codebase). There are many knobs you can tune for retrieval to work well on your codebase.
32
- - **Well-documented experiments**. We profile various strategies (for embeddings, retrieval etc.) on our own benchmark and thoroughly [document the results](benchmarks/retrieval/README.md).
33
-
34
- # Want your repository hosted?
35
-
36
- We're working to make all code on the internet searchable and understandable for devs. You can check out [hosted app](https://sage.storia.ai). We pre-indexed a slew of OSS repos, and you can index your desired ones by simply pasting a GitHub URL.
37
-
38
- If you're the maintainer of an OSS repo and would like a dedicated page on Code Sage (e.g. `sage.storia.ai/your-repo`), then send us a message at [founders@storia.ai](mailto:founders@storia.ai). We'll do it for free!
39
-
40
- ![](assets/sage.gif)
41
-
42
- # Extensions & Contributions
43
-
44
- We built the code purposefully modular so that you can plug in your desired embeddings, LLM and vector stores providers by simply implementing the relevant abstract classes.
45
-
46
- Feel free to send feature requests to [founders@storia.ai](mailto:founders@storia.ai) or make a pull request!
47
-
48
- # Contributors
49
-
50
- <a href="https://github.com/Storia-AI/sage/graphs/contributors">
51
- <img alt="contributors" src="https://contrib.rocks/image?repo=Storia-AI/sage"/>
52
- </a>
53
-
54
- <p align="right" style="font-size: 14px; color: #555; margin-top: 20px;">
55
- <a href="#readme-top" style="text-decoration: none; color: #007bff; font-weight: bold;">
56
- Back to Top
57
- </a>
58
- </p>
 
 
 
1
+ # Codebase Agent 🕷️
2
+
3
+ **Codebase Agent** is an intelligent, local-first code analysis tool that helps you understand, navigate, and query your codebase using advanced AI agents.
4
+
5
+ Think of it as a private, super-powered developer assistant that knows your code inside out.
6
+
7
+ ![Screenshot](assets/logo.png)
8
+
9
+ ## Key Features
10
+
11
+ - **🛡️ 100% Local option**: Run with Ollama + local embeddings for complete privacy.
12
+ - **🧠 Agentic Reasoning**: Uses AST (Abstract Syntax Tree) analysis and Call Graphs to trace execution and dependencies.
13
+ - **🕸️ Call Graph Navigation**: Ask questions like "Who calls `database.connect`?" or "What acts as the entry point?".
14
+ - **⚡ Multiple Providers**: Support for **Google Gemini** (1M+ context), **Groq** (fast inference), and standard OpenAI-compatible APIs.
15
+ - **📂 Universal Ingestion**: Upload ZIP files or point to GitHub repositories.
16
+
17
+ ## 🚀 Quick Start
18
+
19
+ 1. **Clone the repository**:
20
+ ```bash
21
+ git clone https://github.com/Asishkarthikeya/Codebase_Agent.git
22
+ cd Codebase_Agent
23
+ ```
24
+
25
+ 2. **Install dependencies**:
26
+ ```bash
27
+ pip install -r requirements.txt
28
+ ```
29
+
30
+ 3. **Run the application**:
31
+ ```bash
32
+ streamlit run app.py
33
+ ```
34
+
35
+ 4. **Upload & Chat**:
36
+ - Open `http://localhost:8501`
37
+ - Enter your API Key (e.g., Gemini or Groq) in the sidebar
38
+ - Upload a `.zip` of your code or provide a GitHub URL
39
+ - Start chatting!
40
+
41
+ ## 🔧 Configuration
42
+
43
+ The agent creates a `.env` file for your configuration, but you can also set these environment variables manually:
44
+
45
+ - `GOOGLE_API_KEY`: For Gemini models
46
+ - `GROQ_API_KEY`: For Groq models
47
+ - `QDRANT_API_KEY`: For Qdrant vector DB
48
+
49
+ ## 🤖 Agent Credentials
50
+
51
+ This project uses:
52
+ - **Streamlit** for the UI
53
+ - **LangChain** for orchestration
54
+ - **ChromaDB** for vector storage
55
+ - **NetworkX** for code graph analysis
56
+ - **Tree-sitter** for robust parsing
57
+
58
+ ## License
59
+
60
+ MIT License. See [LICENSE](LICENSE) for details.
assets/storia-logo.png DELETED
Binary file (11.2 kB)
 
setup.py CHANGED
@@ -1,4 +1,15 @@
1
  # Work-around the fact that `pip install -e .` doesn't work with `pyproject.toml` files.
2
  from setuptools import setup
3
 
4
- setup()
 
 
 
 
 
 
 
 
 
 
 
 
1
  # Work-around the fact that `pip install -e .` doesn't work with `pyproject.toml` files.
2
  from setuptools import setup
3
 
4
+ setup(
5
+ name="code_chatbot",
6
+ version="0.1.0",
7
+ packages=["code_chatbot", "api"],
8
+ install_requires=[
9
+ "streamlit",
10
+ "langchain",
11
+ "chromadb",
12
+ "networkx",
13
+ "tree-sitter",
14
+ ],
15
+ )