aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorterminaldweller <devi@terminaldweller.com>2023-04-27 10:46:00 +0000
committerterminaldweller <devi@terminaldweller.com>2023-04-27 10:46:00 +0000
commitaee6fbba38c0712bff8e4b348a49328d292b725c (patch)
treecf26a9bf73f6f3cd4437ee14fa79ce2c35bf22b0 /README.md
parentupdated the readme (diff)
downloadmagni-aee6fbba38c0712bff8e4b348a49328d292b725c.tar.gz
magni-aee6fbba38c0712bff8e4b348a49328d292b725c.zip
updated the readme
Diffstat (limited to 'README.md')
-rw-r--r--README.md43
1 files changed, 40 insertions, 3 deletions
diff --git a/README.md b/README.md
index 3d7ca34..9f8a723 100644
--- a/README.md
+++ b/README.md
@@ -2,9 +2,46 @@
magni takes a url and upscales all the images inside and returns a simple html page with the images embedded.</br>
```sh
-HTTPS_PROXY=socks5h://127.0.0.1:9094 ./magni.py --url https://chapmanganato.com/manga-dt980702/chapter-184
+usage: magni.py [-h] [--url URL] [--method METHOD] [--port PORT]
+
+options:
+ -h, --help show this help message and exit
+ --url URL, -u URL the url to the page containing the images
+ --method METHOD, -m METHOD
+ the method to use. either fsrcnn or espcn
+ --port PORT, -p PORT the port to serve the images over
+```
+
+## Install and Run
+
+### Install
+```sh
+poetry install
+```
+
+### Run
+```sh
+poetry shell && HTTPS_PROXY=socks5h://127.0.0.1:9094 ./magni.py --url https://chapmanganato.com/manga-dt980702/chapter-184
+```
+you can obviously use `poetry run` as well:
+```sh
+HTTPS_PROXY=socks5h://127.0.0.1:9094 poetry run ./magni.py --url https://chapmanganato.com/manga-dt980702/chapter-184
```
-## Notes
-* `magni` can use a socks5 proxy as is displayed in the above example.</br>
+## Env Vars
+magni recognizes three environment variables:</br>
+
+### HTTPS_PROXY
+You must specify a socks5 proxy here since magni uses `pysocks` to make the connections.</br>
+If the env var is not defined magni will not use any proxy.</br>
+
+### MAGNI_MODEL_PATH
+Path to the directory where magni will store the model.</br>
+If the env var is not defined, magni will use `./models` as a default value.</br>
+
+### MAGNI_IMAGE_PATH
+Path to the directory where magni will store the upscaled images.</br>
+If the env var is not defined or empty magni will use `./images` as a default value.</br>
+
+## TODO
* currently the models we are using are not as effective. I should either fine ones that are specifically trained on greyscale images or just train some myself.</br>