Geraldine commited on
Commit
347d844
·
verified ·
1 Parent(s): 002bcea

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +57 -1
README.md CHANGED
@@ -7,4 +7,60 @@ sdk: static
7
  pinned: false
8
  ---
9
 
10
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
7
  pinned: false
8
  ---
9
 
10
+ # AI-generated EAD/XML records with Speech-to-text command
11
+
12
+ ## Overview
13
+
14
+ The EAD/XML Editor is a web application that allows users to generate EAD/XML records using voice commands. It leverages advanced speech recognition technology and natural language processing models to facilitate the creation of archival descriptions. Users can record their instructions, highlight existing XML content to add context, and send the combined prompt to the Ollama model for processing.
15
+
16
+ ## Features
17
+
18
+ - **Voice Command Input**: Users can record their voice instructions to generate EAD/XML records.
19
+
20
+ - **Contextual Highlighting**: Users can highlight existing XML content and add it to their prompt for better context.
21
+
22
+ - **XML Prettification**: The application includes a feature to format XML content for better readability.
23
+
24
+ - **Collapsible Documentation**: Users can access documentation and browser requirements for using the application effectively.
25
+
26
+ - **WebGPU Support**: The application utilizes WebGPU for efficient processing of audio transcription and model inference.
27
+
28
+ ## Technologies Used
29
+
30
+ - **Whisper-small Model**: Utilizes the [Xenova/whisper-small](https://huggingface.co/Xenova/whisper-small) model for audio transcription, implemented using [transformers.js](https://huggingface.co/docs/transformers.js/index) and leveraging WebGPU in the browser.
31
+
32
+ - **Ollama Model**: Uses the fine-tuned model [hf.co/Geraldine/FineLlama-3.2-3B-Instruct-ead-GGUF:Q5_K_M](https://huggingface.co/Geraldine/FineLlama-3.2-3B-Instruct-ead-GGUF) for generating EAD/XML records based on user instructions and context.
33
+
34
+ ## Getting Started
35
+
36
+ ### Prerequisites
37
+
38
+ - A modern web browser that supports WebGPU (e.g., Google Chrome, Mozilla Firefox, Microsoft Edge).
39
+
40
+ - Ensure that WebGPU is enabled in your browser settings.
41
+
42
+ ### Installation
43
+
44
+ 1. Clone the repository:
45
+ ```
46
+ git clone https://github.com/yourusername/ead-xml-editor.git
47
+ cd ead-xml-editor
48
+ ```
49
+
50
+ 2. Open `index.html` in your preferred web browser.
51
+
52
+ ### Usage
53
+
54
+ 1. Click the "Start Recording" button to begin capturing your voice instructions.
55
+
56
+ 2. Highlight any existing XML content and click "Add to Context" to include it in your prompt.
57
+
58
+ 3. Use the "Prettify XML" button to format your XML content.
59
+
60
+ 4. Click "Send Prompt" to generate the EAD/XML based on your instructions.
61
+
62
+ ### Documentation
63
+
64
+ - Click the "Toggle Documentation" button to view instructions on how to use the application.
65
+
66
+ - Click the "Browser Requirements" button to check the necessary browser settings for WebGPU support.