ℹ️ Note: This is an experimental version of QualCoder with AI-enhanced functionality (using GPT-4). Watch the video below if you want to learn more. |
This version was created by Kai Dröge, based on QualCoder 3.5 I hope that my additions will be integrated in the main version at some point, but this may take a while. Until then, you can use the AI-enhanced version alongside the regular QualCoder. Both apps will not interfere with each other. Watch my video on YouTube: Windows:
MacOS:
Linux:
For general information about the usage of QualCoder visit the official Wiki: https://github.com/ccbogel/QualCoder/wiki |
The rest of this document is from the regular version of QualCoder (with some small updates regarding the AI-based version).
QualCoder is a qualitative data analysis application written in Python.
Text files can be typed in manually or loaded from txt, odt, docx, html, htm, md, epub, and PDF files. Images, video, and audio can also be imported for coding. Codes can be assigned to text, images, and a/v selections and grouped into categories in a hierarchical fashion. Various types of reports can be produced including visual coding graphs, coder comparisons, and coding frequencies.
This software has been used on MacOS and various Linux distros. Instructions and other information are available here: https://qualcoder.wordpress.com/ and on the Github Wiki.
If you like QualCoder please buy me a coffee ...
Note: You should be able to run the AI-based version alongside the regular one.
Optional: VLC for audio/video coding. Optional: ffmpeg installed for speech-to-text and waveform image see here to install ffmpeg on Windows: https://phoenixnap.com/kb/ffmpeg-windows.
For installing from source you will need to have Python 3.8 or a newer version installed.
Use the installer
Download the windows installer from here: https://drive.switch.ch/index.php/s/cYJKPA3JV3fJqDc (switch drive is a secure data sharing platform for Swiss universities)
Alternatively, install from source:
Seriously consider using a virtual environment (commands in point 6 below). Not using a virtual environment may affect other Python software you may have installed.
- Download and install the Python programming language. The minimum version for QualCoder is 3.8. I recommend 3.10 for now. Python3. Download the file (at the bottom of the website) "Windows installer (64-bit)"
IMPORTANT: in the first window of the installation mark the option "Add Python to PATH"
-
Download the QualCoder software from: https://github.com/kaixxx/QualCoder/tree/ai_integration (green 'Code' button > Download ZIP) or use git to clone the repo (make sure to use the 'ai_integration' branch)
-
Unzip the folder to a location (e.g. downloads).
-
Use the Windows command prompt. Type "cmd" in the Windows Start search engine, and click on the black software "cmd.exe" - the command console for Windows. In the console type or paste, using the right-click mouse copy and paste (ctrl+v does not work)
-
In the command prompt, move (using the
cd
command) into the QualCoder folder. You should be inside the QualCoder-ai_integration folder. e.g.
cd Downloads\QualCoder-ai_integration
- Install and activate the virtual environment. This step can be skipped, but I recommend you do not skip it.
When not using a docker container, we recommend using a virtual environment to install packages. This will ensure that the dependencies for QualCoder are isolated from the rest of your system. On some Windows OS you may need to replace the py command with python3 below:
py -m venv env
env\Scripts\activate
- Install python modules. Type the following:
py -m pip install --upgrade pip
py -m pip install wheel pyqt6 chardet ebooklib openpyxl Pillow ply pdfminer.six pandas plotly pydub python-vlc rispy SpeechRecognition wordcloud xmlschema charset-normalizer
For the AI-integration:
py -m pip install langchain langchain[llms] chromadb sentence-transformers fuzzysearch pydantic
Wait, until all modules are installed.
Note: on some Windows computers, you may have to type python3
instead of py
as py
may not be recognised.
- Install Qualcoder, from the downloaded folder and type
py -m pip install .
The py
command uses the most recent installed version of Python. You can use a specific version on your Windows if you have many Python versions installed, e.g. py -3.10
See discussion here: Difference between py and python
- Run QualCoder from the command prompt
py -m qualcoder
- If running QualCoder in a virtual environment, to exit the virtual environment type:
deactivate
The command prompt will then remove the (env) wording.
To start QualCoder again
If you are not using a virtual environment, as long as you are in the same drive letter, eg C:
py -m qualcoder
If you are using a virtual environment:
cd
to the Qualcoder-master (or Qualcoder release folder), then type:
env\Scripts\activate.bat
py -m qualcoder
It is best to run QualCoder inside a Python virtual environment so that the system-installed python modules do not clash and cause problems. If you are using the alternative Ubuntu Desktop manager Xfce you may need to run this: sudo apt install libxcb-cursor0
- Recommend that you install vlc (download from site) or:
sudo apt install vlc
- Install pip
sudo apt install python3-pip
- Install venv I am using python3.10 you can choose another recent version if you prefer, and if more recent versions are in the Ubuntu repository.
sudo apt install python3.10-venv
-
Download and unzip the Qualcoder folder.
-
Open a terminal and move (cd) into that folder. You should be inside the QualCoder-master folder or if using a release, e.g. the Qualcoder-3.4 folder. Inside the QualCoder-master folder:
python3.10 -m venv qualcoder
Activate venv, this changes the command prompt display using (brackets): (qualcoder)
Note: To exit venv type deactivate
source qualcoder/bin/activate
- Update pip so that it installs the most recent Python packages.
pip install --upgrade pip
- Install the needed Python modules.
pip install chardet ebooklib ply openpyxl pandas pdfminer pyqt6 pillow pdfminer.six plotly pydub python-vlc rispy six SpeechRecognition xmlschema charset-normalizer
pip install langchain langchain[llms] chromadb sentence-transformers fuzzysearch pydantic
- Install QualCoder, and type the following, the dot is important:
python3 -m pip install .
You may get a warning which can be ignored: WARNING: Building wheel for Qualcoder failed
- To run type
qualcoder
After all this is done, you can deactivate
to exit the virtual environment.
At any time to start QualCoder in the virtual environment, cd to the Qualcoder-master (or Qualcoder release folder), then type:
source qualcoder/bin/activate
Then type
qualcoder
It has not been tested, but please see the above instructions to build QualCoder inside a virtual environment. The below installation instructions may affect system-installed python modules.
- Install modules from the command line
sudo pacman -S python python-chardet python-openpyxl python-pdfminer python-pandas python-pillow python-ply python-pyqt6 python-pip
- Install additional python modules
sudo python3 -m pip install ebooklib plotly pydub python-vlc rispy SpeechRecognition xmlschema charset-normalizer
sudo python3 -m pip install langchain langchain[llms] chromadb sentence-transformers fuzzysearch pydantic
If successful, all requirements are satisfied.
- Build and install QualCoder, from the downloaded folder type
sudo python setup.py install
- To run type:
qualcoder
Or install from AUR as follows:
yay -S qualcoder
Please see the above instructions to build QualCoder inside a virtual environment.
The instructions work on Mac Monterey. It is recommended to use a virtual environment, see: https://sourabhbajaj.com/mac-setup/Python/virtualenv.html The below instructions can be used inside a virtual environment folder instead of placed in Applications.
You will need to install developer tools for macOS. See https://www.cnet.com/tech/computing/install-command-line-developer-tools-in-os-x/
-
Download the latest release "Source code" version in ZIP format: https://github.com/kaixxx/QualCoder/tree/ai_integration (green 'Code' button > Download ZIP). Extract it into /Applications
-
Open the Terminal app (or any other command shell)
-
Install PIP using these commands (if not already installed). Check pip is installed: try typing
pip3 --version
and hit ENTER)
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py
-> You should now be able to run pip3
as above.
- Install Python dependency modules using
pip
:
pip3 install chardet ebooklib openpyxl pandas pillow ply pdfminer.six plotly pydub pyqt6 python-vlc rispy six SpeechRecognition xmlschema charset-normalizer
pip3 install langchain langchain[llms] chromadb sentence-transformers fuzzysearch pydantic
Be sure that you are in the QualCoder-ai_integration directory before doing Step 6.
To change the directory, enter or copy and run the script below.
cd /Applications/QualCoder-ai_integration
- From the QualCoder-Master directory run the setup script:
python3 -m pip install .
You can now run with:
python3 /Applications/QualCoder-ai_integration/qualcoder/__main__.py
Alternative commands to run QualCoder (Suggestions):
From any directory:
qualcoder
From the QualCoder-Master directory:
python3 -m qualcoder
or
python3 qualcoder/__main__.py
You can install QualCoder anywhere you want, so the path above depends on where you extracted the archive.
Another option to run Qualcoder is shown here: https://www.maketecheasier.com/run-python-script-in-mac/. This means you can right-click on the qualcoder.py file and open with --> python launcher. You can make an alias to the file and place it on your desktop.
Another option to install on Mac:
Open the Terminal App and move to the unzipped Qualcoder-ai_integration directory, then run the following commands:
- Install Python dependency modules using
pip3
:
pip3 install chardet ebooklib ffmpeg-python pyqt6 pillow ply pdfminer.six openpyxl pandas plotly pydub python-vlc rispy six SpeechRecognition xmlschema charset-normalizer
pip3 install langchain langchain[llms] chromadb sentence-transformers fuzzysearch pydantic
- Open the Terminal App and move to the unzipped Qualcoder-ai_integration directory, then run the following commands:
pip3 install -U py2app
or for a system installation of python sudo pip3 install -U py2app
python3 setup.py py2app
Required:
Python 3.8+ version, pyqt6, Pillow, six (Mac OS), ebooklib, ply, chardet, pdfminer.six, openpyxl, pandas, plotly, pydub, python-vlc, rispy, SpeechRecognition, xmlschema, charset-normalizer, langchain langchain[llms] chromadb sentence-transformers fuzzysearch pydantic
QualCoder is distributed under the MIT LICENSE.
Curtain, C. & Dröge, K. (2023) QualCoder AI beta [Computer software]. Retrieved from https://github.com/kaixxx/QualCoder/tree/ai_integration
Dr. Colin Curtain BPharm GradDipComp Ph.D. Pharmacy lecturer at the University of Tasmania. I obtained a Graduate Diploma in Computing in 2011. I have developed my Python programming skills from this time onwards. The QualCoder project originated from my use of RQDA during my PhD - Evaluation of clinical decision support provided by medication review software. My original and now completely deprecated PyQDA software on PyPI was my first attempt at creating qualitative software. The reason for creating the software was that during my PhD RQDA did not always install or work well for me, but I did realise that I could use the same SQLite database and access it with Python. The current database is different from the older RQDA version. This is an ongoing hobby project, perhaps a labour of love, which I utilize with some of the Masters's and Ph.D. students I supervise. I do most of my programming on Ubuntu using the PyCharm editor, and I do a small amount of testing on Windows. I do not have a Mac or other operating system to check how well the software works regards installation and usage.
https://www.utas.edu.au/profiles/staff/umore/colin-curtain
https://scholar.google.com/citations?user=KTMRMWoAAAAJ&hl=en
Dr. Kai Dröge, PhD in sociology (with a background in computer science), qualitative researcher and teacher, Lucerne University for Applied Science (Switzerland) and Institute for Social Research, Frankfurt/M. (Germany).
I'm also the author of noScribe, an AI-based audio transcription app that runs locally on your computer and is made for qualitative research.
If you like QualCoder and find it useful for your work. Please leave a review on these sites:
https://www.saashub.com/qualcoder-alternatives
https://alternativeto.net/software/qualcoder
Also, if you like Qualcoder a lot and want to advertise interest in its use, please write an article about your experience using QualCoder.
To allow everyone to discuss all things QualCoder.
Facebook page: https://www.facebook.com/qualcoder
Facebook group: https://www.facebook.com/groups/1251478525589873