LONGYKING
commited on
Commit
·
442ee03
1
Parent(s):
6818f5e
hugging face space deployment fixes
Browse files
README.md
CHANGED
|
@@ -1,11 +1,21 @@
|
|
| 1 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
|
| 3 |
-
|
| 4 |
|
|
|
|
| 5 |
|
| 6 |
## Requirements
|
| 7 |
|
| 8 |
-
The list below contains all the requirements needed to have a complete developer environment to
|
| 9 |
Follow the links to install or update these tools on your machine.
|
| 10 |
|
| 11 |
1. [Python 3.12+](https://www.python.org/downloads/release/python-3120/)
|
|
@@ -13,17 +23,15 @@ Follow the links to install or update these tools on your machine.
|
|
| 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`
|
| 20 |
-
2. Get a copy of the
|
| 21 |
3. Create a virtual environment: `python -m venv env`
|
| 22 |
4. Activate the virtual environment: `source env/bin/activate`
|
| 23 |
-
|
| 24 |
-
|
| 25 |
-
|
| 26 |
-
|
| 27 |
|
| 28 |
## Project Overview
|
| 29 |
|
|
@@ -36,17 +44,15 @@ The project is structured as follows:
|
|
| 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
|
| 43 |
2. Follow the development, structure and documentation patterns of the `src/tools/coin_data_toolkit.py` to build classes
|
| 44 |
-
3. Pay attention to the `constants` variables and `caching` decorators to optimize
|
| 45 |
4. Create new classes in the appropriate folders to maintain an organized codebase and project
|
| 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.
|
|
@@ -68,38 +74,19 @@ For this project, we will be using a very simple version of the Gitflow workflow
|
|
| 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
|
| 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
|
| 88 |
-
5. Write enough unit
|
| 89 |
-
|
| 90 |
-
## HUGGING FACE DEPLOYMENT
|
| 91 |
-
|
| 92 |
-
---
|
| 93 |
-
title: ChatXBT
|
| 94 |
-
emoji: 💬
|
| 95 |
-
colorFrom: purple
|
| 96 |
-
colorTo: pink
|
| 97 |
-
sdk: docker
|
| 98 |
-
sdk_version: "latest"
|
| 99 |
-
app_file: chatxbt-assistant.py
|
| 100 |
-
pinned: false
|
| 101 |
-
---
|
| 102 |
-
|
| 103 |
-
# ChatXBT
|
| 104 |
-
|
| 105 |
-
Welcome to ChatXBT! This project is a Chainlit app deployed on Hugging Face spaces.
|
|
|
|
| 1 |
+
---
|
| 2 |
+
title: ChatXBT
|
| 3 |
+
emoji: 💬
|
| 4 |
+
colorFrom: purple
|
| 5 |
+
colorTo: pink
|
| 6 |
+
sdk: docker
|
| 7 |
+
sdk_version: "latest"
|
| 8 |
+
app_file: chatxbt-assistant.py
|
| 9 |
+
pinned: false
|
| 10 |
+
---
|
| 11 |
|
| 12 |
+
# ChatXBT Web3 AI Assistant Service
|
| 13 |
|
| 14 |
+
AI-powered unification and execution protocol for web3 applications
|
| 15 |
|
| 16 |
## Requirements
|
| 17 |
|
| 18 |
+
The list below contains all the requirements needed to have a complete developer environment to start working on this project.
|
| 19 |
Follow the links to install or update these tools on your machine.
|
| 20 |
|
| 21 |
1. [Python 3.12+](https://www.python.org/downloads/release/python-3120/)
|
|
|
|
| 23 |
3. [Pip Installer](https://pip.pypa.io/en/stable/installation/)
|
| 24 |
4. [Python Venv](https://docs.python.org/3/library/venv.html)
|
| 25 |
|
|
|
|
| 26 |
## Installation
|
| 27 |
|
| 28 |
1. Clone the repository: `git clone https://github.com/ChatXBT/chatxbt-web3-ai-assistant.git`
|
| 29 |
+
2. Get a copy of the `.env` file from the project manager
|
| 30 |
3. Create a virtual environment: `python -m venv env`
|
| 31 |
4. Activate the virtual environment: `source env/bin/activate`
|
| 32 |
+
5. Install the dependencies: `pip install -r requirements.txt`
|
| 33 |
+
6. Run the application: `chainlit run chatxbt-assistant.py -w`
|
| 34 |
+
7. Open the application in your browser: `http://localhost:8000`
|
|
|
|
| 35 |
|
| 36 |
## Project Overview
|
| 37 |
|
|
|
|
| 44 |
5. src/search_services: `a list of search services that can be used to retrieve data for the AI assistant.`
|
| 45 |
6. src/tools: `a list of tools that can be used to extend the functionality of the AI assistant.`
|
| 46 |
|
|
|
|
| 47 |
## Guides
|
| 48 |
|
| 49 |
1. Follow the development, structure and documentation patterns of the `src/tools/coin_data_toolkit.py` to build custom toolkits
|
| 50 |
2. Follow the development, structure and documentation patterns of the `src/tools/coin_data_toolkit.py` to build classes
|
| 51 |
+
3. Pay attention to the `constants` variables and `caching` decorators to optimize performance of class functions/methods across the project
|
| 52 |
4. Create new classes in the appropriate folders to maintain an organized codebase and project
|
| 53 |
5. After installing any new package run `` to update the dependency requirements list
|
| 54 |
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.
|
| 55 |
|
|
|
|
| 56 |
## Git Workflow
|
| 57 |
|
| 58 |
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.
|
|
|
|
| 74 |
3. Push your changes to the remote repository: `git push origin bugfix/my-bugfix`
|
| 75 |
4. Open a pull request on GitHub and request a review from a team member.
|
| 76 |
5. Deploy the bugfix branch to a staging environment for testing.
|
| 77 |
+
6. Once testing is finished, merge the pull request into the main branch.
|
| 78 |
7. Once the pull request is approved, merge it into the main branch.
|
| 79 |
8. Delete the bugfix branch: `git branch -d bugfix/my-bugfix`
|
| 80 |
9. Update your local main branch: `git checkout main && git pull origin main`
|
| 81 |
|
| 82 |
+
## Deployment to production
|
|
|
|
| 83 |
|
| 84 |
To be finalised and added
|
| 85 |
|
|
|
|
| 86 |
## TODO
|
| 87 |
|
| 88 |
1. Add deployment instructions
|
| 89 |
2. Setup CI/CD pipelines for automatic deployment
|
| 90 |
3. Setup and integrate `LiteLLM` instance for LLM service high availability
|
| 91 |
+
4. Add RPC class for remote method calls to other ChatXBT services written in other languages such as `JS`, `TS` & `GO`
|
| 92 |
+
5. Write enough unit tests to ensure class and function input and output correctness
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|