Sigmund AI
Copyright 2023-2026 Sebastiaan Mathôt
A Python library and web app for an LLM-based chatbot:
Features:
- Privacy: all messages and uploaded attachments are encrypted so that no-one can listen in on your conversation
- Expert knowledge: access to documentation
- Continuous conversation: conversations are summarized when they become too long to fit into the prompt
- Tool use (in research-assistant mode):
- Memento: improve memory with persistent notes
- Literature search: ability to search for articles on OpenAlex and Google Scholar
- Image generation: ability to generate images with Flux.2
- Integrations
- Python: connect to JupyterLab, Notebook, Spyder or Rapunzel
- OpenSesame: directly integrate with OpenSesame
- Sigmund Analyst: directly integrate with Sigmund Analyst for data analysis
Sigmund is not a large language model itself. Rather it uses third-party models. Currently, models from OpenAI, Anthropic, Mistral, and Z.ai are supported. API keys from these respective providers are required.
Configuration
See sigmund/config.py for configuration instructions.
Dependencies
For Python dependencies, see pyproject.toml. In addition to these, pandoc is required for the ability to read attachments, and a local redis server needs to run for persistent data between sessions.
Running (development)
Download the source code, and copy .env.example to .env. Edit this file to specify at least the API keys, and depending on the functionality that you want activate, possibly also other variables. The only variable that is strictly required is the OpenAI API key, because OpenAI is used to create text embeddings, even when a different model is used for the conversation.
Next, install the dependencies, build the documentation index, and launch the app!
pip install . # install dependencies
python index_library.py # build library (documentation) index
python app.py # start the app
Next, access the app (by default) through:
http://127.0.0.1:5000/
Running (production)
In production, the server is generally not run by directly calling the app. There are many ways to run a Flask app in production. One way is to use gunicorn to start the app, and then use an nginx web server as a proxy that reroutes requests to the app. When taking this route, make sure to set up nginx with a large client_max_body_size (to allow attachment uploading) and disable proxy_cache and proxy_buffering (to allow status messages to be streamed while Sigmund is answering).
License
Sigmund is distributed under the terms of the GNU General Public License 3. The full license should be included in the file COPYING, or can be obtained from:
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sigmund-2.3.1.tar.gz.
File metadata
- Download URL: sigmund-2.3.1.tar.gz
- Upload date:
- Size: 6.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
825701d2a3819529c0ec05c4db2f704876678252b8098e6662216e03a80871d0
|
|
| MD5 |
9986f4742e92d7551e7615292732aa83
|
|
| BLAKE2b-256 |
a9502d80f0213c4b54d468d9ba42b88cab5c6619446c7e62cb159164071afd41
|
File details
Details for the file sigmund-2.3.1-py3-none-any.whl.
File metadata
- Download URL: sigmund-2.3.1-py3-none-any.whl
- Upload date:
- Size: 6.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e8c659125c03da5bdfe7839ddf0c5bc1197ee3ee7a9c9626c9d3b053ef31364b
|
|
| MD5 |
fff5f5816d815d27bfc6a0dd31e59553
|
|
| BLAKE2b-256 |
9f0b02ebecbb8d5802ec2782746e6df944a9e1db97329e6b36fb8eedac82d7c3
|
