|
1 | | -# Algorithm Audit AI Tooling. |
| 1 | +# Algorithm Audit AI Tooling |
2 | 2 |
|
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. |
4 | 4 |
|
5 | | -## pyodide upgrade |
| 5 | +## Features |
6 | 6 |
|
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