README.md.original 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. # SimplyTranslate Web
  2. This is a simple web interface for SimplyTranslate
  3. ## List of Instances
  4. You can find a list of instances here: [SimplyTranslate Project Page](https://simple-web.org/projects/simplytranslate.html)
  5. If you want to integrate a list of instances in your project, you can use this endpoint to always have an up-to-date list of all instances known to us: [https://simple-web.org/instances/simplytranslate](https://simple-web.org/instances/simplytranslate)
  6. If you want to add your own instance here, please either send me an email directly to simpleweb@metalune.xyz or tell us about it in our IRC channel #simple-web on [Libera.Chat](https://libera.chat)
  7. ## How to install/use
  8. ### Clone the repository
  9. ```sh
  10. git clone https://codeberg.org/SimpleWeb/SimplyTranslate-Web
  11. cd SimplyTranslate-Web
  12. ```
  13. ### Install the dependencies
  14. ```sh
  15. pip install -r requirements.txt
  16. ```
  17. ### Run the main.py
  18. ```sh
  19. # Directly
  20. python3 main.py
  21. # Using uvicorn
  22. uvicorn main:app --port 5000
  23. ```
  24. ### Configuration
  25. You can configure SimplyTranslate by editing these files:
  26. Either this in the project directory:
  27. ```
  28. config.conf
  29. ```
  30. Shared Between all supported SimplyTranslate Frontends (like SimplyTranslate-Gemini):
  31. ```
  32. /etc/simplytranslate/shared.conf
  33. ```
  34. Configuration file specifically for this frontend:
  35. ```
  36. /etc/simplytranslate/web.conf
  37. ```
  38. Or if you want to specify your own config file path you can just pass the argument `-c` or `--config`
  39. ## How to contribute
  40. 1. Setup git-email: https://git-send-email.io
  41. 2. Clone the repo you want: `git clone https://codeberg.org/SimpleWeb/SimplyTranslate-Web`
  42. 3. Branch it: `git checkout -b my-cool-changes`
  43. 4. Add your changes: `git add .` and commit them `git commit -m "My Cool Changes"`
  44. 5. Set mail-to: `git config sendemail.to '~metalune/simplytranslate-devel@lists.sr.ht'`
  45. 6. Send your commit: `git send-email master`
  46. ## API
  47. [Documentation](./api.md)
  48. ## Contact
  49. To get in contact with the developers, visit us on the #simple-web IRC channel on [Libera.Chat](https://libera.chat)
  50. ## License
  51. SimplyTranslate-Web is free software: you can redistribute it and/or modify
  52. it under the terms of the GNU Affero General Public License as published by
  53. the Free Software Foundation, either version 3 of the License, or
  54. (at your option) any later version.
  55. SimplyTranslate-Web is distributed in the hope that it will be useful,
  56. but WITHOUT ANY WARRANTY; without even the implied warranty of
  57. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  58. GNU Affero General Public License for more details.