Skip to content

Commit d0537cf

Browse files
committed
Update readme to provide install and usage instructions.
1 parent 7441808 commit d0537cf

File tree

1 file changed

+111
-11
lines changed

1 file changed

+111
-11
lines changed

README.md

Lines changed: 111 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,114 @@
1-
# Algorithm Audit AI Tooling.
1+
# Algorithm Audit AI Tooling
22

3-
Run `npm run dev` to start the development server.
3+
A web-based tool for bias detection and synthetic data generation in AI systems. This project runs entirely in the browser using Pyodide for Python computations.
44

5-
## pyodide upgrade
5+
## Features
66

7-
- upgrade pyoide in package.json
8-
- upgrade files in public/pyodide
9-
- download from https://github.com/pyodide/pyodide/releases and extract the files
10-
- download pyodide and pyodide-core
11-
- place only the needed files from pyodide in the public/pyodide-[version] folder
12-
- place all files from pyodide-core in the public/pyodide-[version] folder
13-
- change the use-worker.ts file to point to the new version
14-
7+
- **Bias Detection**: Analyze datasets for potential biases in AI systems
8+
- **Synthetic Data Generation**: Create synthetic datasets while preserving privacy
9+
- **Browser-based Computation**: Utilizes Pyodide for running Python code directly in the browser
10+
- **Interactive Visualizations**: Includes various charts and visualizations for data analysis
11+
- **Multilingual Support**: Available in English and Dutch
12+
13+
## Prerequisites
14+
15+
- Node.js (v16 or higher)
16+
- npm (v8 or higher)
17+
18+
## Installation
19+
20+
1. Clone the repository:
21+
22+
```bash
23+
git clone [repository-url]
24+
cd [your-repository-directory]
25+
```
26+
27+
2. Install dependencies:
28+
29+
```bash
30+
npm install
31+
```
32+
33+
## Usage
34+
35+
### Development
36+
37+
Run the development server:
38+
39+
```bash
40+
npm run dev
41+
```
42+
43+
This will start the Vite development server, typically at `http://localhost:5173`
44+
45+
### Building for Production
46+
47+
Build the project:
48+
49+
```bash
50+
npm run build
51+
```
52+
53+
Preview the production build:
54+
55+
```bash
56+
npm run preview
57+
```
58+
59+
### Code Formatting and Linting
60+
61+
Format code:
62+
63+
```bash
64+
npm run format
65+
```
66+
67+
Run linter:
68+
69+
```bash
70+
npm run lint
71+
```
72+
73+
Fix linting issues:
74+
75+
```bash
76+
npm run lint:fix
77+
```
78+
79+
## Project Structure
80+
81+
- `/src` - Source code
82+
- `/assets` - Static assets and code examples
83+
- `/components` - React components
84+
- `/routes` - Page components
85+
- `/lib` - Utility functions
86+
- `/locales` - Translation files
87+
- `/public` - Static files and Python dependencies
88+
- `/pyodide-0.27.3` - Pyodide distribution files
89+
- `/datasets` - Example datasets for testing
90+
91+
## Pyodide
92+
93+
The project uses Pyodide v0.27.3 for running Python code in the browser. To upgrade Pyodide:
94+
95+
- upgrade pyoide in package.json
96+
- upgrade files in public/pyodide
97+
- download from https://github.com/pyodide/pyodide/releases and extract the files
98+
- download pyodide and pyodide-core
99+
- place only the needed files from pyodide in the public/pyodide-[version] folder
100+
- place all files from pyodide-core in the public/pyodide-[version] folder
101+
- change the use-worker.ts file to point to the new version
102+
103+
## Development Scripts
104+
105+
- `npm run dev` - Start development server
106+
- `npm run build` - Build for production
107+
- `npm run preview` - Preview production build
108+
- `npm run format` - Format code using Prettier
109+
- `npm run lint` - Run ESLint
110+
- `npm run lint:fix` - Fix linting issues automatically
111+
112+
## License
113+
114+
This project is licensed under the terms specified in the LICENSE file.

0 commit comments

Comments
 (0)