[BUG] Quickstart offline install based on User Guide depends on conda
Description
Conda and a venv needs to be setup for the quickstart install based on the User Guide.
This dependency needs to be called out for Linux. Error below.
I attempted to install miniconda manually and setup an venv but I'm having issues. In the meantime, the User Guide documented dependencies should be updated for Linux.
Reproduction steps
1. Go to https://cinnamon.github.io/kotaemon/
2. Download & unzip latest release
3. Run 'bash run_linux.sh'
4. See error
Screenshots

Logs
$ bash run_linux.sh
******************************************************
Setting up Miniconda
******************************************************
Downloading Miniconda from
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 141M 100 141M 0 0 2828k 0 0:00:51 0:00:51 --:--:-- 2881k
Installing Miniconda to /media/justin/external/bin/kotaemon-app/install_dir/conda
PREFIX=/media/justin/external/bin/kotaemon-app/install_dir/conda
Unpacking payload ...
Installing base environment...
Preparing transaction: ...working... done
Executing transaction: ...working... done
installation finished.
Miniconda is installed at /media/justin/external/bin/kotaemon-app/install_dir/conda
Conda version:
conda 24.9.2
******************************************************
Creating conda environment
******************************************************
Creating conda environment with python=3.10 in /media/justin/external/bin/kotaemon-app/install_dir/env
Channels:
- defaults
Platform: linux-64
Collecting package metadata (repodata.json): done
Solving environment: done
## Package Plan ##
environment location: /media/justin/external/bin/kotaemon-app/install_dir/env
added / updated specs:
- python=3.10
The following packages will be downloaded:
package | build
---------------------------|-----------------
pip-24.2 | py310h06a4308_0 2.3 MB
python-3.10.15 | he870216_1 26.8 MB
setuptools-75.1.0 | py310h06a4308_0 1.7 MB
wheel-0.44.0 | py310h06a4308_0 109 KB
------------------------------------------------------------
Total: 30.9 MB
The following NEW packages will be INSTALLED:
_libgcc_mutex pkgs/main/linux-64::_libgcc_mutex-0.1-main
_openmp_mutex pkgs/main/linux-64::_openmp_mutex-5.1-1_gnu
bzip2 pkgs/main/linux-64::bzip2-1.0.8-h5eee18b_6
ca-certificates pkgs/main/linux-64::ca-certificates-2024.9.24-h06a4308_0
ld_impl_linux-64 pkgs/main/linux-64::ld_impl_linux-64-2.40-h12ee557_0
libffi pkgs/main/linux-64::libffi-3.4.4-h6a678d5_1
libgcc-ng pkgs/main/linux-64::libgcc-ng-11.2.0-h1234567_1
libgomp pkgs/main/linux-64::libgomp-11.2.0-h1234567_1
libstdcxx-ng pkgs/main/linux-64::libstdcxx-ng-11.2.0-h1234567_1
libuuid pkgs/main/linux-64::libuuid-1.41.5-h5eee18b_0
ncurses pkgs/main/linux-64::ncurses-6.4-h6a678d5_0
openssl pkgs/main/linux-64::openssl-3.0.15-h5eee18b_0
pip pkgs/main/linux-64::pip-24.2-py310h06a4308_0
python pkgs/main/linux-64::python-3.10.15-he870216_1
readline pkgs/main/linux-64::readline-8.2-h5eee18b_0
setuptools pkgs/main/linux-64::setuptools-75.1.0-py310h06a4308_0
sqlite pkgs/main/linux-64::sqlite-3.45.3-h5eee18b_0
tk pkgs/main/linux-64::tk-8.6.14-h39e8969_0
tzdata pkgs/main/noarch::tzdata-2024b-h04d1e81_0
wheel pkgs/main/linux-64::wheel-0.44.0-py310h06a4308_0
xz pkgs/main/linux-64::xz-5.4.6-h5eee18b_1
zlib pkgs/main/linux-64::zlib-1.2.13-h5eee18b_1
Downloading and Extracting Packages:
Preparing transaction: done
Verifying transaction: done
Executing transaction: done
#
# To activate this environment, use
#
# $ conda activate /media/justin/external/bin/kotaemon-app/install_dir/env
#
# To deactivate an active environment, use
#
# $ conda deactivate
Activate conda environment at /media/justin/external/bin/kotaemon-app/install_dir/env
******************************************************
Installing requirements
******************************************************
Installing Kotaemon v0.7.2
ERROR: Could not find an activated virtualenv (required).
ERROR: Could not find an activated virtualenv (required).
ERROR: Could not find an activated virtualenv (required).
Installation failed. You may need to run the installer again.
Deactivate conda environment at /media/justin/external/bin/kotaemon-app/install_dir/env
Browsers
No response
OS
Linux
Additional information
LinuxMint 21.3 (based on Ubuntu 22)
I got miniconda installed, reran the Kotaemon run_linux.sh, but it still gives the same error.
Conda claims to see the Kotaemon environment:
$ conda env list
# conda environments:
#
base * /media/justin/external/CodeReady/conda/miniconda
kotaemon /media/justin/external/CodeReady/conda/miniconda/envs/kotaemon
/media/justin/external/bin/kotaemon-app/install_dir/conda
/media/justin/external/bin/kotaemon-app/install_dir/env
But when I rerun the installer:
$ bash run_linux.sh
******************************************************
Setting up Miniconda
******************************************************
Miniconda is installed at /home/justin/external-ssd/bin/kotaemon-app/install_dir/conda
Conda version:
conda 24.9.2
******************************************************
Creating conda environment
******************************************************
Conda environment exists at /home/justin/external-ssd/bin/kotaemon-app/install_dir/env
Activate conda environment at /home/justin/external-ssd/bin/kotaemon-app/install_dir/env
******************************************************
Installing requirements
******************************************************
Installing Kotaemon v0.7.2
ERROR: Could not find an activated virtualenv (required).
ERROR: Could not find an activated virtualenv (required).
ERROR: Could not find an activated virtualenv (required).
Installation failed. You may need to run the installer again.
Deactivate conda environment at /home/justin/external-ssd/bin/kotaemon-app/install_dir/env
Hmm.... what could be happening here?
I made some progress and got the kotaemon app running.
After installing miniconda, I also activated a venv. Reran run_linux.sh, and it started downloading packages.
So both 1) an activated Python venv and 2) an active conda are required for this basic User Guide install.
Does that sound right?
This process doesn't seem much simpler than the dev install ... is the intention for the Zip to be an AIO (All-In-One) or click-n-run? If that's the intention, the docs should say there's dependencies and setup.
@vap0rtranz Perhaps the solution to this discussion can help you:https://stackoverflow.com/questions/16460313/pip-could-not-find-an-activated-virtualenv-required