lemdaddy commited on
Commit
e3b2ea9
·
1 Parent(s): 0e9ebd7

Update README.md with Git workflow strategy

Browse files
Files changed (1) hide show
  1. README.md +39 -6
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
- ## Development
 
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
- TODO: Add deployment instructions
52
- TODO: Setup CI/CD pipelines for automatic deployment
53
- TODO: Setup and integrate `LitLLM` instance for LLM service high availability
54
- TODO: Add RPC class for remmote method calls to other chatxbt services written in other launguages such as `JS`, `TS` & `GO`
55
- TODO: Write enough unit test to ensure class and function input and output correctness
 
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