Skip to content

Commit cb700fb

Browse files
committed
update readme - draft
1 parent 7192594 commit cb700fb

3 files changed

Lines changed: 236 additions & 67 deletions

File tree

README.md

Lines changed: 39 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,19 @@
11
<p align="center">
2-
<a href="https://aider.chat/"><img src="https://aider.chat/assets/logo.svg" alt="Aider Logo" width="300"></a>
2+
<a href="https://github.com/Devin-Cook/explORE-AI"><img src="./assets/explore_logo.svg" alt="explORE-AI Logo" width="300"></a>
33
</p>
44

5-
<h1 align="center">
6-
AI Pair Programming in Your Terminal - Branched Version for ORE use
7-
</h1>
8-
5+
# explORE-AI — A Specialized Fork of Aider for Open Source Risk Engine (ORE)
96

107
<p align="center">
11-
Aider lets you pair program with LLMs to start a new project or build on your existing codebase.
8+
<em>Built upon the amazing foundation of <a href="https://aider.chat/">Aider</a></em>
129
</p>
1310

11+
**explORE-AI** helps you navigate, understand, and contribute to the **Open Source Risk Engine (ORE)** codebase. Originally derived from the powerful [Aider](https://github.com/Aider-AI/aider) AI pair-programming tool, this fork is tailored for **domain-specific insights** into ORE. If you find Aider useful for general purposes, please check out their project. For **ORE-focused** development, read on!
12+
1413
<p align="center">
1514
<img
16-
src="https://aider.chat/assets/screencast.svg"
17-
alt="aider screencast"
15+
src=".\assets\terminal.svg"
16+
alt="explORE-AI screencast"
1817
>
1918
</p>
2019
@@ -34,78 +33,51 @@ src="https://img.shields.io/badge/📈%20Tokens%2Fweek-15B-3498db?style=flat-squ
3433
src="https://img.shields.io/badge/🏆%20OpenRouter-Top%2020-9b59b6?style=flat-square&labelColor=555555"/></a>
3534
<a href="https://aider.chat/HISTORY.html"><img alt="Singularity" title="Percentage of the new code in Aider's last release written by Aider itself"
3635
src="https://img.shields.io/badge/🔄%20Singularity-92%25-e74c3c?style=flat-square&labelColor=555555"/></a>
37-
<!--[[[end]]]-->
36+
<!--[[[end]]]-->
3837
</p>
3938

39+
## Why explORE-AI?
40+
41+
[Open Source Risk Engine (ORE)](https://github.com/OpenSourceRisk/Engine) is a large and sophisticated library for risk analytics, financial instrument modeling, and more. Diving into ORE can be **intimidating** due to its size and complexity.
42+
43+
**explORE-AI**:
44+
45+
- Leverages **Aider**’s AI pair-programming features and **tailors** them for ORE development.
46+
- Provides specialized insights into ORE’s architecture, including analytics, classes, and data relationships.
47+
- Helps generate targeted refactors, test scaffolds, or risk analytics examples relevant to ORE.
48+
49+
We owe a **huge thanks** to [Aider](https://github.com/Aider-AI/aider) for providing the robust foundation that made this fork possible.
50+
4051
## Features
4152

42-
- 🧠 **[Cloud and local LLMs](https://aider.chat/docs/llms.html)** - Aider works best with Claude 3.7 Sonnet, DeepSeek R1 & Chat V3, OpenAI o1, o3-mini & GPT-4o, but can connect to almost any LLM, including local models.
43-
- 🗺️ **[Maps your codebase](https://aider.chat/docs/repomap.html)** - Aider makes a map of your entire codebase, which helps it work well in larger projects.
44-
- `</>` **[100+ code languages](https://aider.chat/docs/languages.html)** - Aider works with most popular programming languages: python, javascript, rust, ruby, go, cpp, php, html, css, and dozens more.
45-
- 🔀 **[Git integration](https://aider.chat/docs/git.html)** - Aider automatically commits changes with sensible commit messages. Use familiar git tools to easily diff, manage and undo AI changes.
46-
- 🖥️ **[Use in your IDE](https://aider.chat/docs/usage/watch.html)** - Use aider from within your favorite IDE or editor. Ask for changes by adding comments to your code and aider will get to work.
47-
- 🖼️ **[Images & web pages](https://aider.chat/docs/usage/images-urls.html)** - Add images and web pages to the chat to provide visual context, screenshots, reference docs, etc.
48-
- 🎤 **[Voice-to-code](https://aider.chat/docs/usage/voice.html)** - Speak with aider about your code! Request new features, test cases or bug fixes using your voice and let aider implement the changes.
49-
-**[Linting & testing](https://aider.chat/docs/usage/lint-test.html)** - Automatically lint and test your code every time aider makes changes. Aider can fix problems detected by your linters and test suites.
50-
- 📋 **[Copy/paste to web chat](https://aider.chat/docs/usage/copypaste.html)** - Work with any LLM via its web chat interface. Aider streamlines copy/pasting code context and edits back and forth with a browser.
53+
- 🏦 **ORE-Specific Insights****explORE-AI** can reference and analyze ORE’s specific code structure, giving more precise guidance.
54+
- 🗺️ **Codebase Mapping** — Just like Aider, but with a deeper understanding of the ORE ecosystem.
55+
- 🧠 **[Cloud and Local LLMs](https://aider.chat/docs/llms.html)** — Choose from Claude, DeepSeek, GPT variants, or almost any other LLM.
56+
- `</>` **[Multi-Language Support](https://aider.chat/docs/languages.html)** — Even though ORE is mostly C++, explORE-AI supports 100+ coding languages.
57+
- 🔀 **[Git Integration](https://aider.chat/docs/git.html)** — Automatic commits with sensible messages, so you can track AI-generated changes effortlessly.
58+
- 🏗️ **Domain-Specific Testing & Linting** — Integrates smoothly with ORE’s tests or any specialized linters to ensure high-quality code.
59+
- 🗣️ **Voice-to-Code** — Request new features, bug fixes, or run analytics queries by voice.
60+
- 📋 **[Copy/Paste Web Chat](https://aider.chat/docs/usage/copypaste.html)** — If you need to jump into a browser-based LLM environment, explORE-AI makes it easier.
5161

5262
## Getting Started
5363

5464
```bash
55-
python -m pip install aider-install
65+
# 1. Clone this explORE-AI repository
66+
git clone https://github.com/Devin-Cook/explORE-AI.git
67+
cd explORE-AI
68+
69+
# 2. Install
70+
python -m pip install .
5671
aider-install
5772

58-
# Change directory into your codebase
59-
cd /to/your/project
73+
# 3. Navigate to your ORE codebase
74+
cd /path/to/OpenSourceRiskEngine
6075

61-
# DeepSeek
76+
# 4. Launch explORE-AI with your preferred model:
6277
aider --model deepseek --api-key deepseek=<key>
6378

64-
# Claude 3.7 Sonnet
79+
# Example for Claude:
6580
aider --model sonnet --api-key anthropic=<key>
6681

67-
# o3-mini
82+
# Example for o3-mini:
6883
aider --model o3-mini --api-key openai=<key>
69-
```
70-
71-
See the [installation instructions](https://aider.chat/docs/install.html) and [usage documentation](https://aider.chat/docs/usage.html) for more details.
72-
73-
## More Information
74-
75-
### Documentation
76-
- [Installation Guide](https://aider.chat/docs/install.html)
77-
- [Usage Guide](https://aider.chat/docs/usage.html)
78-
- [Tutorial Videos](https://aider.chat/docs/usage/tutorials.html)
79-
- [Connecting to LLMs](https://aider.chat/docs/llms.html)
80-
- [Configuration Options](https://aider.chat/docs/config.html)
81-
- [Troubleshooting](https://aider.chat/docs/troubleshooting.html)
82-
- [FAQ](https://aider.chat/docs/faq.html)
83-
84-
### Community & Resources
85-
- [LLM Leaderboards](https://aider.chat/docs/leaderboards/)
86-
- [GitHub Repository](https://github.com/Aider-AI/aider)
87-
- [Discord Community](https://discord.gg/Tv2uQnR88V)
88-
- [Blog](https://aider.chat/blog/)
89-
90-
## Kind Words From Users
91-
92-
- *"The best free open source AI coding assistant."*[IndyDevDan](https://youtu.be/YALpX8oOn78)
93-
- *"The best AI coding assistant so far."*[Matthew Berman](https://www.youtube.com/watch?v=df8afeb1FY8)
94-
- *"Aider ... has easily quadrupled my coding productivity."*[SOLAR_FIELDS](https://news.ycombinator.com/item?id=36212100)
95-
- *"It's a cool workflow... Aider's ergonomics are perfect for me."*[qup](https://news.ycombinator.com/item?id=38185326)
96-
- *"It's really like having your senior developer live right in your Git repo - truly amazing!"*[rappster](https://github.com/Aider-AI/aider/issues/124)
97-
- *"What an amazing tool. It's incredible."*[valyagolev](https://github.com/Aider-AI/aider/issues/6#issue-1722897858)
98-
- *"Aider is such an astounding thing!"*[cgrothaus](https://github.com/Aider-AI/aider/issues/82#issuecomment-1631876700)
99-
- *"It was WAY faster than I would be getting off the ground and making the first few working versions."*[Daniel Feldman](https://twitter.com/d_feldman/status/1662295077387923456)
100-
- *"THANK YOU for Aider! It really feels like a glimpse into the future of coding."*[derwiki](https://news.ycombinator.com/item?id=38205643)
101-
- *"It's just amazing. It is freeing me to do things I felt were out my comfort zone before."*[Dougie](https://discord.com/channels/1131200896827654144/1174002618058678323/1174084556257775656)
102-
- *"This project is stellar."*[funkytaco](https://github.com/Aider-AI/aider/issues/112#issuecomment-1637429008)
103-
- *"Amazing project, definitely the best AI coding assistant I've used."*[joshuavial](https://github.com/Aider-AI/aider/issues/84)
104-
- *"I absolutely love using Aider ... It makes software development feel so much lighter as an experience."*[principalideal0](https://discord.com/channels/1131200896827654144/1133421607499595858/1229689636012691468)
105-
- *"I have been recovering from multiple shoulder surgeries ... and have used aider extensively. It has allowed me to continue productivity."*[codeninja](https://www.reddit.com/r/OpenAI/s/nmNwkHy1zG)
106-
- *"I am an aider addict. I'm getting so much more work done, but in less time."*[dandandan](https://discord.com/channels/1131200896827654144/1131200896827654149/1135913253483069470)
107-
- *"After wasting $100 on tokens trying to find something better, I'm back to Aider. It blows everything else out of the water hands down, there's no competition whatsoever."*[SystemSculpt](https://discord.com/channels/1131200896827654144/1131200896827654149/1178736602797846548)
108-
- *"Aider is amazing, coupled with Sonnet 3.5 it's quite mind blowing."*[Josh Dingus](https://discord.com/channels/1131200896827654144/1133060684540813372/1262374225298198548)
109-
- *"Hands down, this is the best AI coding assistant tool so far."*[IndyDevDan](https://www.youtube.com/watch?v=MPYFPvxfGZs)
110-
- *"[Aider] changed my daily coding workflows. It's mind-blowing how a single Python application can change your life."*[maledorak](https://discord.com/channels/1131200896827654144/1131200896827654149/1258453375620747264)
111-
- *"Best agent for actual dev work in existing codebases."*[Nick Dobos](https://twitter.com/NickADobos/status/1690408967963652097?s=20)

assets/explore_logo.svg

Lines changed: 43 additions & 0 deletions
Loading

assets/terminal.svg

Lines changed: 154 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)