Metadata-Version: 2.1
Name: cortesh
Version: 0.1.0
Summary: Your AI Pair programmer.
Home-page: https://github.com/zeopix/cortesh
License: MIT
Author: Iván Guillén
Author-email: hello@ivanguillen.me
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: langchain (>=0.3.0,<0.4.0)
Requires-Dist: langchain-openai (>=0.2.0,<0.3.0)
Requires-Dist: numpy (>=1.21.0,<2.0.0)
Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
Requires-Dist: requests (==2.28.1)
Description-Content-Type: text/markdown

# 🧠 **Cortesh** — COgnitive Real-Time Software Helper ⚡

![Python](https://img.shields.io/badge/python-v3.8+-blue.svg) ![CLI](https://img.shields.io/badge/cli-automation-brightgreen.svg) ![Langchain](https://img.shields.io/badge/langchain-powered-ff69b4.svg) ![OpenAI](https://img.shields.io/badge/OpenAI-api-orange.svg)

## **Introduction** 🎯

**cortesh** is a LLM based CLI tool that interacts with your coding project. It aims to:
- 🚀 Quickly bootstrap new software projects.
- 📂 Generate embeddings and/or custom trainings for your existing projects.
- 📑 Implement features and functionalities.
- ⚡ Create and run tests.
- 🐞Debug and fix bugs. 
- 🔒Automatic security and performance analysis.

## **Demo** 📺

[![Cortesh Demo](https://img.youtube.com/vi/EZqdUPMIz0k/0.jpg)](https://www.youtube.com/watch?v=EZqdUPMIz0k)


---

## **Roadmap** ✨
- [x] Initialize with OpenAI.
- [x] [ Logic ] - folder_project - entry point to handle user requests on a folder project.
- [x] [ Output ] Write files and run commands from LLM answers.
- [x] [ Logic ] Feedback loop for command outputs. Flow control. 
- [x] [ Sense ] Read current files and project structure, flow control by LLM.
- [ ] [ Memory ] Generate embeddings on curent project structure, include GIT/LLM generated descriptions.
- [ ] [ Logic ] Use the memory embedidngs in flow control
- [ ] Some kind of testing...



## **Installation** 🛠️

```bash
pip install cortesh
```

## **GOAL** 🎯
To be able to fully implement a feature on a public repository in a completely autonomous way.


## **Inspiration and Bibliography** 🌟
- [Code Generation with AlphaCodium](https://arxiv.org/abs/2401.08500)
- [Many-Shot In-Context learning](https://arxiv.org/pdf/2404.11018)
- [Chain of Agents: Large Language Models Collaborating on Long-Context Tasks](https://arxiv.org/abs/2406.02818)


---

## **Usage** 💻

Go to the folder where you want to start working and run:

```bash
cortesh
```


## **Contributing** 🤝

We welcome contributions! Here's how you can help:

1. Fork the repository 🍴
2. Create your feature branch (`git checkout -b feature/your-feature`) 🌱
3. Commit your changes (`git commit -am 'Add some feature'`) 💡
4. Push to the branch (`git push origin feature/your-feature`) 🚀
5. Open a Pull Request ✨

Check the [Contributing Guidelines](#) for more information.

---

## **License** 📜

This project is licensed under the **MIT License**. See the [LICENSE](./LICENSE) file for details.

---

**Happy Coding!** ✨
