[BUG] Quickstart offline install based on User Guide depends on conda

[vap0rtranz]

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

![DESCRIPTION](LINK.png)

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)

[vap0rtranz]

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?

[vap0rtranz]

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.

[KKenny0]

@vap0rtranz Perhaps the solution to this discussion can help you：https://stackoverflow.com/questions/16460313/pip-could-not-find-an-activated-virtualenv-required