bearchainAI

Made for Berkeley Codeology Spring 2023 by Trevor Trinh and Anna Chung.

Project Leaders: Trevor Trinh, Anna Chung
Project Blurb: Tech moves fast, and the fields of blockchain and AI are no exception. Having the ability to operate at the cutting edge is fundamental for both feeding your curiosity and advancing your career in computer science. Our project serves as a gateway of understanding to these technologies, providing hands-on experience with the latest tools and frameworks. We'll be building a web application that utilizes the GPT-3 Davinci artificial intelligence model (fine-tuned with web scraped references) to generate new fanfictions. Motivated by the issue of creator credit in AI-generated media, new fanfiction along with their reference authors will be recorded on the Ethereum blockchain as non-fungible tokens (NFTs).
Tech areas:
- Blockchain, ML, Web Scraping, Web Dev
Tools/technologies involved:
- Blockchain: Solidity, Alchemy, Polygon, Hardhat, MetaMask
- Machine Learning Model: GPT-3 Davinci & Ada
- Web Scraping: Beautiful Soup, lmxl parser
- Web dev: Next.js, React, Chakra UI
- Languages: Python, Solidity, JavaScript (TypeScript)

Setup Onboarding

‼️ IMPORTANT ‼️

Please carefully read the logistics and complete the following tech and repo setup. This is crucial for the smooth operation of your project. If you have any questions or run into any issues, please contact us for assistance!

🎛️ Logistics

~~~ Proj: bearchainAI ~~~

This notion has everything you’ll ever need!

The calendar is the main resource, check it frequently. We will communicate through Facebook Messenger.

Feedback is appreciated! 😊

💻 Tech Setup

Guide for installing and configuring all required software and accounts

Programs

a code editor

any code editor should work but we recommend Visual Studio Code, which you can download here !
Visual Studio Code Python Set Up
- install the Python extension by Microsoft
- install a Python interpreter
  - refer to this link for detailed instructions plus instructions on setting up a simple python program to test that you’re set up works for python
- select Python interpreter version
  - do (ctrl+shift+P) or (cmd+shift+P) to open up the command palette
  - type in “Python: Select Interpreter” and make sure it is a version before 3.11
- make code runner run python3 instead of python in VSC terminal
  - open settings
    - Windows/Linux - File>Preferences>Settings
    - macOS - Code>Preferences>Settings
  - type in preferences: one of the results should have an “edit in settings.json” link, click it
  - change your python value in the json to the following so that the terminal uses python3 instead of python when using codeRunner
```
"python": "python3 -u"
```

python3

check if python is already installed and what version it is by entering this into your terminal:
```
python --version
# or
python3 --version
```
if not installed **or** the version is 3.11, go here and follow download instructions in the ‘looking for specific release’ section to download a previous version (should be python 3.5+ though) - *make sure to check the box that says “Add Python To Path”

pip3

check if pip3 is installed by entering this into your terminal:
```
pip --version
# or
pip3 -v
```
if pip command not found check out this article for trouble shooting (for both windows and mac (home brew))

to upgrade pip enter this in your terminal:

python3 -m pip3 install --upgrade pip
#or
python -m pip3 install --upgrade pip

node.js

check if node.js is already installed
- enter the following into your terminal to check for node as well as npm:
```
node -v
npm -v
```
- if a version is return than node.js and npm are already installed, move onto updating package manager
if not installed
- normal install
  - download node.js here, download LTS version
  - run the installer, keep default settings, press install
- home brew install
  - run the following in your terminal:
```
brew install node
```
- after installation check if node.js and npm is installed by running the following in the terminal again:
```
node -v
npm -v
```
- if version numbers come out you’re good to go
update node package manager (npm)
- windows
  - run the following command in the terminal:
```
npm install npm --global
```
- macOS
  - run the following command in your terminal
```
sudo npm install npm --global
```

yarn

check if you already have yarn installed by running the following in the terminal:
```
yarn --version
```
- if it returns a version you’re good to go else go to the next drop down
install yarn
- run the following in the terminal:
```
npm install --global yarn
# then run this to check that it installed
# properly and returns a version
yarn --version
```
- if that doesn’t work refer to this link and enter in your OS specifics in the ‘alternatives’ drop down and follow those instructions

Accounts

gpt-3

make an open ai account
- (or more than one honestly, you might need it — borrow some phone numbers & emails from friends or family members?)
- we will be using these API keys later

metamask

install metamask chrome extension
- setup your wallet
- we will be using the private key later

alchemy

make an alchemy account
- create a new app on the dashboard with any name and description
- ensure to set the chain and network to polygon/mumbai
- we will be using the API keys later
get some matic
- use the alchemy faucet to receive some test matic

polygonscan

make a polygon scan account
generate a new API key
- we will be using this API key later
add polygon mumbai network to metamask
- scroll to the bottom of mumbai.polyscan and click “Add Mumbai Network”

😸 Repo Setup

Guide for cloning repo, installing dependencies, and setting environment variables for local development and deployment on Replit.

cloning and repo setup

create a new repo on github (make the name zesty)
clone our skeleton code to your local machine
```
git clone <PROJECT URL HERE>
```
set the remote origin to be YOUR newly created repo
- this is so you can make commits to your own repo on github
```
git remote set-url origin <your newly made github repo url>
```
set the remote start origin to be OUR skeleton code repo
- this is so you can get updates to our starter code
```
git remote add starter <PROJECT URL HERE>
```
- after doing so, you can get the latest starter code with the following command
```
git pull starter main
```
once you’ve completed the above, send Trevor the link to your repo via messenger

installing dependencies

python dependencies
- in root of project, create a virtual env and install packages from requirements.txt
```
python3 -m venv venv
pip install -r requirements.txt
```
nodejs dependencies
- in both web/ and blockchain/ install packages from package.json
  - if not use something like nvm to install a compatible node version
```
# in web/ and blockchain/
yarn install
```

env variables

create a .env.local file in web/

ALCHEMY_API_KEY=
ALCHEMY_API_URL=
ALCHEMY_API_WEBSOCKETS=
CONTRACT_ADDRESS=
OPENAI_API_KEY=

create a .env file in blockchain/

ALCHEMY_API_URL=
POLYGONSCAN_API_KEY=
PRIVATE_KEY=

local dev workflow

for the web interface, run yarn dev to view project at localhost:3000
do devvy work, make commits, and push to github

replit deployment

make a replit account
import github repo

update secrets json

{
  "ALCHEMY_API_KEY": "",
  "ALCHEMY_API_URL": "",
  "ALCHEMY_API_WEBSOCKETS": "",
  "CONTRACT_ADDRESS": "",
  "OPENAI_API_KEY": ""
}

can pull latest repo changes in the command line to share your updates

kazemi1367 / bearchainAI