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
Release files for sigmund 2.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sigmund-2.4.1.tar.gz | 6.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sigmund-2.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.2 MB
Release files / sigmund-2.4.1.tar.gz
| Download URL | sigmund-2.4.1.tar.gz |
|---|---|
| Size | 6.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c07f558214b14201896d929769ece8c69ea24362a9bf42bfa8dbb64baf3a9eba
|
|
BLAKE2b-256 checksum How to use checksums |
cbd72afdf3c69c9e3c6a0aba9d3b3185f251c12c8ec0b0b7ba75fe619fc72098
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / sigmund-2.4.1-py3-none-any.whl
| Download URL | sigmund-2.4.1-py3-none-any.whl |
|---|---|
| Size | 6.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
89b37295dc0c14b42c9c563d7256f4305597c6204430c98c59bd1aa2dd80c2c3
|
|
BLAKE2b-256 checksum How to use checksums |
9f75c67e1c3b691fb9561e5312c9c63187d71d8b06f3d9bb588c21aae54cce5b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
