HipparchiaGoServer v2.0.3

WARNING: REQUIRES A DATABASE BUILT WITH HipparchiaGoBuilder

[look undermigration below for further details]

FEATURES

• default configuration files generated on first run
• database self-installation on first run
• searching
  • search scope selections
  • search scope exclusions
  • near/not-near syntax
  • progress polling
  • automatic rewrites of searches to optimize for speed
  • can cancel long in-progress searches (and/or vectorizations)
• dictionaries
• text browsing
• text maker
• indexing (+ flag unique forms)
• vocabulary list generation (+ flag unique headwords)
• morphology tables
• embedded help files
• variety of embedded fonts
• selectable css color themes
• tweakable css color themes (command line only)
• semantic vectors
  • general
    • configurable model parameters
    • configurable lists of stop-words
    • choice of text building strategies
  • nearest neighbors
    • search for terms and yield a table and an interactive graph of nearest neighbors
    • choice of graphing styles: "neighbors" or "neighbors + neighbors of neighbors"
    • configure how many neighbors to track
    • choice of modeling algorithms
  • topic models
    • configure number of topics to track
    • option to build an interactive graph the LDA model via t-SNE reduction (graphs can be 2d or 3d)

INSTRUCTIONS

• for installation, see the INSTRUCTIONS folder
• when running: hover over UI elements to get quick tips
• when running: click on ? at bottom corner for detailed help
• see also antisigma for video demos

NOTES

• c. 150MB resident RAM on launch (note that a simple application like iTerm2 uses 354MB and Firefox uses 855MB)
• add about 125MB of RAM per postgres client connection in the pool
• a very heavy search like all forms of πόλιϲ near... can kick you up into 660MB

MINIMUM VERSION OF GOLANG REQUIRED TO BUILD

• go 1.25 because GOEXPERIMENT=greenteagc,jsonv2 is invoked at build time
• if you turn that off, then go 1.22 because slices.Concat is called

MIGRATION TO v2.0.0+

• HipparchiaGoServer v1.4.0 is the last version that will run with data generated by the python of HipparchiaBuilder (which ceased development at v1.6.2 on 08 Mar 2023)
• as of Jun 2025 all users are expected to migrate to HipparchiaGoBuilder database builds in order to run HipparchiaGoServer v2.0.0+
• HipparchiaBuilder databases and HipparchiaGoBuilder databases can co-exist and HipparchiaGoServer v1.4.0 and HipparchiaGoServer v2.0.0+ can run simultaneously without mutual interference.
• some time after successful migration to v2.0.0+ one should consider deleting/archiving the old HipparchiaBuilder database and retaining only the HipparchiaGoBuilder database
• • note that the server now defaults to 127.0.0.1:8001 instead of 127.0.0.1:8000. You might need to update some browser bookmarks.