athul / jimbru

A lightweight analytics server with FastAPI and deta.sh Base as DB. A glorified hit-counter of sorts 😁

IMPORTANT: There seems to be an error in deploying this, planning for a rewrite of the whole.

Jimbru

Jimbru is an Privacy Oriented web analytics Server which is built with FastAPI and Deta Base as DB.

Jimbru is heavily inspired by Shynet which is also an Analytics server built with Django.

Not for Production Level use. It's hacky to the core. I made it for a Personal Use and doesn't have any fancy features.

Features

• Lightweight
• Privacy Oriented
• Easily Deployable (on deta.sh)
• 6 lines of JS code gets the current URL, referrer and load time.
• Charts with Frappe Charts 📊
• Jinja2 Templating and Tailwind CSS for Frontend
• Cookie based Authentication
• User OS and device from user-agent header
• user location and network from user ip header

Not Included Features

• Caching
• Bounce rate
• Session Time
• Unique Hits

Demo

Deploying

Before deploying you need to get some Credentials

Prep Work

• Signup for an account in https://deta.sh

• Create a new Project

• Get the Project Key and save it in the .env file as below

• Install the Deta cli. This is for deploying to Deta.

• Create a .env file inside the app/routes directory with the following keys

  TITLE=<title of the site>
  DOMAIN=<domain of the deployed server>
  PKEY=<Deta Project Key>
  PNAME=<Deta Base DB Name>
  SECRET_JWT=<Secret for JWT. Get than with→ import os; print(os.urandom(24).hex())>
  USERNAME=<username for authenticating>
  PASSWORD=<password for authenticating>

The PNAME can be anything.

---

1. Fork/Clone this Repository
2. You can run the code locally by installing the dependencies inside the app directory and running uvicorn main:app --reload inside the app directory.
3. Inside the app directory you can create a new Micro with $ deta new. This will create a new Micro. You will get the domian from the output of the command. Save that domain in the DOMAIN key in the .env file, without a trailing /.
4. Run $ deta update -e routes/.env to update the environment variables in the micro.
5. Run $ deta deploy inside the app directory and the code will be deployed.
6. Profit

---

Usage

Add a <script> tag for the site

<script src="https://<DOMAIN>/a.js" type="text/javascript"></script>

TODO

• Caching
• Better Auth
• Session Time

LICENSE

MIT

Contributors

• @akhilmhdh

jimbru's Issues

Error while running the analyzer.

Hi, I got this error after following all the steps in the instructions:

  File "/var/task/main.py", line 3, in <module>
    from routes import analytics,templates,auth
  File "/var/task/routes/templates.py", line 7, in <module>
    from .auth import manager
  File "/var/task/routes/auth.py", line 10, in <module>
    manager = LoginManager(SECRET,tokenUrl="/auth/login",use_cookie=True)
TypeError: __init__() got an unexpected keyword argument 'tokenUrl'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/opt/python/detalib/debugger.py", line 142, in wrap
    result = func(event, context)
  File "/var/task/_entry.py", line 12, in handler
    import main  # noqa
  File "/var/task/main.py", line 5, in <module>
    from .routes import analytics,templates,auth
ImportError: attempted relative import with no known parent package

Please help with the issue.
Thanks.