Update README.md with Git workflow strategy
Browse files
README.md
CHANGED
|
@@ -2,6 +2,7 @@
|
|
| 2 |
|
| 3 |
AI-powered unification and execution protocol for web3 applications
|
| 4 |
|
|
|
|
| 5 |
## Requirements
|
| 6 |
|
| 7 |
The list below contains all the requirements needed to have a complete developer environment to sart working on this project.
|
|
@@ -12,6 +13,7 @@ Follow the links to install or update these tools on your machine.
|
|
| 12 |
3. [Pip Installer](https://pip.pypa.io/en/stable/installation/)
|
| 13 |
4. [Python Venv](https://docs.python.org/3/library/venv.html)
|
| 14 |
|
|
|
|
| 15 |
## Installation
|
| 16 |
|
| 17 |
1. Clone the repository: `git clone https://github.com/ChatXBT/chatxbt-web3-ai-assistant.git`
|
|
@@ -22,7 +24,8 @@ Follow the links to install or update these tools on your machine.
|
|
| 22 |
5. Run the application: `chainlit run chatxbt-assistant.py -w`
|
| 23 |
6. Open the application in your browser: `http://localhost:8000`
|
| 24 |
|
| 25 |
-
|
|
|
|
| 26 |
|
| 27 |
The project is structured as follows:
|
| 28 |
|
|
@@ -33,6 +36,7 @@ The project is structured as follows:
|
|
| 33 |
5. src/search_services: `a list of search services that can be used to retrieve data for the AI assistant.`
|
| 34 |
6. src/tools: `a list of tools that can be used to extend the functionality of the AI assistant.`
|
| 35 |
|
|
|
|
| 36 |
## Guides
|
| 37 |
|
| 38 |
1. Follow the development, structure and documentation patterns of the `src/tools/coin_data_toolkit.py` to build custom toolkits
|
|
@@ -42,14 +46,43 @@ The project is structured as follows:
|
|
| 42 |
5. After installing any new package run `` to update the dependency requirements list
|
| 43 |
6. Expose RPC functions for SDKs that do not support python runtime. use [DeepKit](https://deepkit.io/documentation/rpc) and [BunJS](https://bun.sh/) if possible.
|
| 44 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 45 |
## Deplopyment to producton
|
| 46 |
|
| 47 |
To be finalised and added
|
| 48 |
|
|
|
|
| 49 |
## TODO
|
| 50 |
|
| 51 |
-
|
| 52 |
-
|
| 53 |
-
|
| 54 |
-
|
| 55 |
-
|
|
|
|
| 2 |
|
| 3 |
AI-powered unification and execution protocol for web3 applications
|
| 4 |
|
| 5 |
+
|
| 6 |
## Requirements
|
| 7 |
|
| 8 |
The list below contains all the requirements needed to have a complete developer environment to sart working on this project.
|
|
|
|
| 13 |
3. [Pip Installer](https://pip.pypa.io/en/stable/installation/)
|
| 14 |
4. [Python Venv](https://docs.python.org/3/library/venv.html)
|
| 15 |
|
| 16 |
+
|
| 17 |
## Installation
|
| 18 |
|
| 19 |
1. Clone the repository: `git clone https://github.com/ChatXBT/chatxbt-web3-ai-assistant.git`
|
|
|
|
| 24 |
5. Run the application: `chainlit run chatxbt-assistant.py -w`
|
| 25 |
6. Open the application in your browser: `http://localhost:8000`
|
| 26 |
|
| 27 |
+
|
| 28 |
+
## Project Overview
|
| 29 |
|
| 30 |
The project is structured as follows:
|
| 31 |
|
|
|
|
| 36 |
5. src/search_services: `a list of search services that can be used to retrieve data for the AI assistant.`
|
| 37 |
6. src/tools: `a list of tools that can be used to extend the functionality of the AI assistant.`
|
| 38 |
|
| 39 |
+
|
| 40 |
## Guides
|
| 41 |
|
| 42 |
1. Follow the development, structure and documentation patterns of the `src/tools/coin_data_toolkit.py` to build custom toolkits
|
|
|
|
| 46 |
5. After installing any new package run `` to update the dependency requirements list
|
| 47 |
6. Expose RPC functions for SDKs that do not support python runtime. use [DeepKit](https://deepkit.io/documentation/rpc) and [BunJS](https://bun.sh/) if possible.
|
| 48 |
|
| 49 |
+
|
| 50 |
+
## Git Workflow
|
| 51 |
+
|
| 52 |
+
For this project, we will be using a very simple version of the Gitflow workflow. This workflow is designed to manage the development, release, and maintenance of software projects. It provides a clear and structured approach to managing branches, releases, and feature development.
|
| 53 |
+
|
| 54 |
+
### Feature
|
| 55 |
+
|
| 56 |
+
1. Create a branch off of main branch: `git checkout -b feature/my-feature`
|
| 57 |
+
2. Make your changes and commit them: `git commit -m "Add my feature"`
|
| 58 |
+
3. Push your changes to the remote repository: `git push origin feature/my-feature`
|
| 59 |
+
4. Open a pull request on GitHub and request a review from a team member.
|
| 60 |
+
5. Once the pull request is approved, merge it into the main branch.
|
| 61 |
+
6. Delete the feature branch: `git branch -d feature/my-feature`
|
| 62 |
+
7. Update your local main branch: `git checkout main && git pull origin main`
|
| 63 |
+
|
| 64 |
+
### Bugfix
|
| 65 |
+
|
| 66 |
+
1. For bug fixes, create a branch off of main branch: `git checkout -b bugfix/my-bugfix`
|
| 67 |
+
2. Make your changes and commit them: `git commit -m "Fix my bug"`
|
| 68 |
+
3. Push your changes to the remote repository: `git push origin bugfix/my-bugfix`
|
| 69 |
+
4. Open a pull request on GitHub and request a review from a team member.
|
| 70 |
+
5. Deploy the bugfix branch to a staging environment for testing.
|
| 71 |
+
6. Once testing is finished, merge the pull request into the main branch.
|
| 72 |
+
7. Once the pull request is approved, merge it into the main branch.
|
| 73 |
+
8. Delete the bugfix branch: `git branch -d bugfix/my-bugfix`
|
| 74 |
+
9. Update your local main branch: `git checkout main && git pull origin main`
|
| 75 |
+
|
| 76 |
+
|
| 77 |
## Deplopyment to producton
|
| 78 |
|
| 79 |
To be finalised and added
|
| 80 |
|
| 81 |
+
|
| 82 |
## TODO
|
| 83 |
|
| 84 |
+
1. Add deployment instructions
|
| 85 |
+
2. Setup CI/CD pipelines for automatic deployment
|
| 86 |
+
3. Setup and integrate `LiteLLM` instance for LLM service high availability
|
| 87 |
+
4. Add RPC class for remmote method calls to other chatxbt services written in other launguages such as `JS`, `TS` & `GO`
|
| 88 |
+
5. Write enough unit test to ensure class and function input and output correctness
|