Omnilog allows you to easily monitor your LLM project!
- Simply run our initialisation script on your AWS account
- Start our listener in your python project,
- View your logs and analytics in your privately deployed web app!
(For developer setup information, refer to the Developer Info section at the bottom of the page)
Get started with OmniLog in five easy steps:
-
Ensure you have an AWS account with a user that has the necessary permissions to bootstrap our project into your AWS. You can check & follow the steps here to do that.
-
Configure a Postgres database:
- We recommend Neon for an simple setup with a very generous free tier. You will need the connection string later (This can be found on the homepage after creating your Neon project) e.g:
- Third, clone our repository:
git clone https://github.com/Theodo-UK/OmniLog.git
- Bootstrap the project onto your AWS by running the following script:
bash ./init.sh
-
Once finished, you should see a
SiteUrl
in your terminal. Copy it, navigate to ./front/.env.production and paste it in the NEXTAUTH_URL property. -
Run the
init.sh
script again, and skip the configuring of the .env files to deploy your web app properly. -
Use the Python SDK inside your LLM project:
from omnilogger import start_openai_listener
start_openai_listener()
# write your code after calling the listener
...
That's it! You should now be able to see your logs at the AWS URI given from init.sh
. See the sdk-python docs for more details. To share your project with others, see the Adding new users guide.
If you want to remove the AWS resources, then you simply have to call this script:
./teardown.sh
⚠️ REMOVAL POLICY: By default, AWS does not remove resources like S3 buckets or DynamoDB tables. You will need to modify these manually via the AWS console.
We welcome contributions from the community to help improve OmniLog. You can contribute in the following ways:
Contribute to the Web App by setting up a development environment as outlined in the Dev-setup guide.
Contribute to the Omnilogger pip package by following the guidelines provided in the Python SDK documentation.
Your contributions are valuable and greatly appreciated! If you have ideas for improvements, feature requests, or bug reports, please don't hesitate to open an issue or create a pull request.
Thank you for your support in making OmniLog even better!