JoanGiner commited on
Commit
20aa495
·
1 Parent(s): 43ca3c6

added readme for hf

Browse files
Files changed (1) hide show
  1. README.md +9 -47
README.md CHANGED
@@ -1,47 +1,9 @@
1
- # The Software Diversity Card webform generator 🏢
2
-
3
- Welcome to the Software Diversity Card Generator—a form-based application designed to empower you to highlight and promote diversity in software projects. Our innovative tool helps you generate comprehensive diversity cards in both JSON and Markdown formats, offering a transparent overview of the varied teams involved in development and governance, the user groups engaged in testing, and the tailored software adaptations for different social groups. By providing a structured model, an extended JSON syntax, and a toolkit backed by real-world examples, our platform aims to foster inclusive practices that can be embraced by open-source communities, academic journals, and forward-thinking businesses alike.
4
-
5
-
6
- ## Public demo and other tools
7
-
8
- We have released a public demo of the web-form generator at: www.dummy.org
9
-
10
- Do you prefer filling the card using your favourite IDE? Try out the Visual Studio Code language pluguin here: www.vscodemarket.org/ourtool
11
-
12
-
13
- ## Dependencies
14
-
15
- It is recommended to use a virtual environment, i.e., the following commands should be run before installing the dependencies:
16
-
17
- ```console
18
- python3 -m venv .venv
19
- source .venv/bin/activate
20
- ```
21
-
22
- This project relies on [Streamlit 1.x](https://github.com/streamlit/streamlit). To install the dependencies run:
23
-
24
- ```console
25
- pip install -r requirements.txt
26
- ```
27
-
28
- ## Running the service
29
-
30
- After setting up the virtual environment and installing the dependencies, run the following command to start the server:
31
-
32
- ```console
33
- streamlit run server.py
34
- ```
35
-
36
- The streamlit listening port can be customized by setting the `--server.port` parameter:
37
-
38
- ```console
39
- streamlit run server.py --server.port 2000
40
- ```
41
-
42
- By default, the server expects an Impropmptu REST service at `http://127.0.0.1:3000` as well as Ollama server at `http://127.0.0.1:11434`. You can override these settings by setting the `-i`/`--impromptu.url` and `o`/`--ollama.url` arguments. Please notice that these arguments **MUST** be passed after the `streamlit` arguments, and separated by two dashes, e.g.:
43
-
44
- ```console
45
- streamlit run server.py --server.port 2000 -- --impromptu.url "http://example.com:3000" --ollama.url "http://example.com:11434"
46
- ```
47
-
 
1
+ title: SoftwareDiversityCardGenerator
2
+ emoji: 👁
3
+ colorFrom: green
4
+ colorTo: green
5
+ sdk: gradio
6
+ sdk_version: 3.32.0
7
+ app_file: app.py
8
+ pinned: false
9
+ license: apache-2.0