rens

command module
v0.0.0-...-0753cfa Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 31, 2025 License: AGPL-3.0 Imports: 20 Imported by: 0

README

rens

Frontend for Google Lens

About

More lightweight. Designed to preserve your privacy. All communication to google servers happens through the instance. Uploaded filenames are replaced with randomized filename. Metadata is also stripped

Implemented

  • Image translation
  • OCR

Instances

You can be here too :D -- Create an issue or send me an email/message on xmpp: [email protected]

Hosting your own instance

Using Docker

Easiest solution. You must have Docker and Git installed

  1. git clone https://git.maid.zone/stuff/rens
  2. cd rens
  3. touch cookies.txt
  4. chmod 0666 cookies.txt
  5. cp compose.example.yaml compose.yaml
  6. docker compose up -d

rens listens on port 4664 by default

Manual build

Recommended for development. If you are going to use this method to deploy, for better performance you should precompress files (go tool soundcloakctl -nozstd -notable precompress)

You must have Go and Git installed

  1. git clone https://git.maid.zone/stuff/rens
  2. cd rens
  3. go tool templ generate
  4. go build main.go
  5. ./main

You can run main binary now to run rens

Configuration

You can set environment variables to configure

  • rens_unix_socket: set this to path where you would like to listen on unix socket. Rens also tries to remove this file at startup. Disabled by default
  • rens_unix_perms: set this to permissions for the unix socket, 0777 for example. Disabled by default
  • rens_addr: set this to address/port for rens to listen on. Set to :4664 by default
  • rens_prefork: run multiple instances of rens locally to be able to handle more requests. Set to false by default
  • rens_use_fs: load static files from OS filesystem instead of using embedded files. Set to false by default

Contributing

Contributions are appreciated! If you wanna add something new, please discuss with others first.

If you added new go dependencies or updated existing ones, run go mod tidy

If you have any questions, or just wanna talk about rens, you can join the maid.zone XMPP chat: [email protected]

Any security vulnerabilities should first be disclosed privately to the maintainer

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
lib

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL