Use the Command-Line Interface#

architxt#

architxtUsage: architxt [OPTIONS] COMMAND [ARGS]...ArchiTXT is a tool for structuring textual data into a valid database model. It is guided by a meta-grammar and uses an iterative process of tree rewriting.╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--install-completionInstall completion for the current shell.││--show-completionShow completion for the current shell, to copy it or customize the││installation.                                                     ││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮│ui          Launch the web-based UI.                                                          ││cleanup     Cleanup a forest retaining only the valid tree structure                          ││simplify    Simplify a bunch of databased together.                                           ││simplify-llmSimplify a bunch of databased together.                                           ││inspect     Display statistics of a dataset.                                                  ││compare     Simplify a bunch of databased together.                                           ││generate    Generate synthetic instance.                                                      ││cache-clear Clear all the cache of ArchiTXT                                                   ││load        ││export      │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

ui#

uiUsage: architxt ui [OPTIONS]Launch the web-based UI.╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

cleanup#

cleanupUsage: architxt cleanup [OPTIONS] FILES...Cleanup a forest retaining only the valid tree structure╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*filesFILES...Path of the data files to load.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--tauFLOAT RANGE [0<=x<=1]The similarity threshold.││[default: 0.7]           ││--decayFLOAT RANGE [x>=0.001]The similarity decay factor.││[default: 2]                ││--outputPATH                  Path to save the result.││--metrics--no-metricsShow metrics of the simplification.││[default: no-metrics]              ││--in-memory--no-in-memoryPerform the cleanup in memory.││[default: no-in-memory]       ││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

simplify#

simplifyUsage: architxt simplify [OPTIONS] FILES...Simplify a bunch of databased together.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*filesFILES...Path of the data files to load.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--tauFLOAT RANGE [0<=x<=1]The similarity        ││threshold.            ││[default: 0.7]        ││--decayFLOAT RANGE [x>=0.001]The similarity decay  ││factor.               ││[default: 2]          ││--epochINTEGER RANGE [x>=1]Number of iteration   ││for tree rewriting.   ││[default: 100]        ││--min-supportINTEGER RANGE [x>=1]Minimum support for   ││tree patterns.        ││[default: 20]         ││--similarity[instance|schema]Mode for similarity   ││calculation.          ││'instance' uses       ││instance-level        ││similarity, 'schema'  ││uses schema-level     ││similarity.           ││[default: instance]   ││--workersINTEGER RANGE [x>=1]Number of parallel    ││worker processes to   ││use. Defaults to the  ││number of available   ││CPU cores.            ││--outputPATH                  Path to save the      ││result.               ││--debug--no-debugEnable debug mode for ││more verbose output.  ││[default: no-debug]   ││--metrics--no-metricsShow metrics of the   ││simplification.       ││[default: no-metrics] ││--log--no-logEnable logging to     ││MLFlow.               ││[default: no-log]     ││--log-system-metrics--no-log-system-metri…Enable logging of     ││system metrics to     ││MLFlow.               ││[default:             ││no-log-system-metrics]││--in-memory--no-in-memoryPerform the           ││simplification in     ││memory.               ││[default:             ││no-in-memory]         ││--helpShow this message and ││exit.                 │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

simplify-llm#

simplify-llmUsage: architxt simplify-llm [OPTIONS] FILES...Simplify a bunch of databased together.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*filesFILES...Path of the data files to load.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--tauFLOAT RANGE [0<=x<=1]The similarity        ││threshold.            ││[default: 0.7]        ││--decayFLOAT RANGE [x>=0.001]The similarity decay  ││factor.               ││[default: 2]          ││--min-supportINTEGER RANGE [x>=1]Minimum support for   ││vocab.                ││[default: 20]         ││--vocab-similarityFLOAT RANGE [0<=x<=1]The vocabulary        ││similarity threshold. ││[default: 0.6]        ││--refining-stepsINTEGER               Number of refining    ││steps.                ││[default: 0]          ││--outputPATH                  Path to save the      ││result.               ││--intermediate-outputPATH                  Path to save          ││intermediate results. ││--debug--no-debugEnable debug mode for ││more verbose output.  ││[default: no-debug]   ││--metrics--no-metricsShow metrics of the   ││simplification.       ││[default: no-metrics] ││--log--no-logEnable logging to     ││MLFlow.               ││[default: no-log]     ││--log-system-metrics--no-log-system-metr…Enable logging of     ││system metrics to     ││MLFlow.               ││[default:             ││no-log-system-metrics]││--model-providerTEXT                  Provider of the model.││[default: huggingface]││--modelTEXT                  Model to use for the  ││LLM.                  ││[default:             ││HuggingFaceTB/SmolLM2…││--max-tokensINTEGER               Maximum number of     ││tokens to generate.   ││[default: 2048]       ││--local--no-localUse local model.││[default: local]││--openvino--no-openvinoEnable Intel OpenVINO ││optimizations.        ││[default: no-openvino]││--rate-limitFLOAT                 Rate limit for the    ││LLM.                  ││--estimate--no-estimateEstimate the number of││tokens to generate.   ││[default: no-estimate]││--temperatureFLOAT                 Temperature for the   ││LLM.                  ││[default: 0.2]        ││--in-memory--no-in-memoryPerform the           ││simplification in     ││memory.               ││[default:             ││no-in-memory]         ││--helpShow this message and ││exit.                 │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

inspect#

inspectUsage: architxt inspect [OPTIONS] FILES...Display statistics of a dataset.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*filesFILES...Path of the data files to load.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--redundancy--no-redundancyCompute redundancy metrics.[default: no-redundancy]││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

compare#

compareUsage: architxt compare [OPTIONS] SRC DSTSimplify a bunch of databased together.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*srcPATHPath of the data file to compare to.[required]││*dstPATHPath of the data file to compare.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--tauFLOAT RANGE [0<=x<=1]The similarity threshold.[default: 0.7]││--decayFLOAT RANGE [x>=0.001]The similarity decay factor.[default: 2]││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

generate#

generateUsage: architxt generate [OPTIONS]Generate synthetic instance.╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--sampleINTEGER RANGE [x>=1]Number of sentences to sample from the corpus.││[default: 100]                                ││--outputPATH                Path to save the result.││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

cache-clear#

cache-clearUsage: architxt cache-clear [OPTIONS]Clear all the cache of ArchiTXT╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--force--no-forceForce the deletion of the cache without asking.[default: no-force]││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

load#

loadUsage: architxt load [OPTIONS] COMMAND [ARGS]...╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮│documentExtract document database into a formatted tree.                                      ││sql     Extract a SQL compatible database into a formatted tree.                              ││graph   Extract a cypher/bolt compatible database into a formatted tree.                      ││corpus  Extract a database schema form a corpus.                                              │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

document#

documentUsage: architxt load document [OPTIONS] FILEExtract document database into a formatted tree.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*filePATHThe document file to read.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--raw--no-rawEnable row reading, skipping   ││any transformation to convert  ││it to the metamodel.           ││[default: no-raw]              ││--root-nameTEXT                The root node name.││[default: ROOT]    ││--sampleINTEGER RANGE [x>=1]Number of element to sample    ││from the document.             ││--outputPATH                Path to save the result.││--merge-existing--no-merge-existingShould we merge data if output ││file already exist             ││[default: no-merge-existing]   ││--incremental--no-incrementalEnable incremental loading of  ││the database.                  ││[default: incremental]         ││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

sql#

sqlUsage: architxt load sql [OPTIONS] URIExtract a SQL compatible database into a formatted tree.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*uriTEXTDatabase connection string.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--simplify-association--no-simplify-associ…Simplify association   ││tables.                ││[default:              ││simplify-association]  ││--sampleINTEGER RANGE [x>=1]Number of sentences to ││sample from the corpus.││--outputPATH                Path to save the       ││result.                ││--merge-existing--no-merge-existingShould we merge data if││output file already    ││exist                  ││[default:              ││no-merge-existing]     ││--incremental--no-incrementalEnable incremental     ││loading of the         ││database.              ││[default: incremental] ││--helpShow this message and  ││exit.                  │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

graph#

graphUsage: architxt load graph [OPTIONS] URIExtract a cypher/bolt compatible database into a formatted tree.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*uriTEXTDatabase connection string.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--usernameTEXT                Username to use for            ││authentication.                ││[default: neo4j]               ││--passwordTEXT                Password to use for            ││authentication.                ││--sampleINTEGER RANGE [x>=1]Number of sentences to sample  ││from the corpus.               ││--outputPATH                Path to save the result.││--merge-existing--no-merge-existingShould we merge data if output ││file already exist             ││[default: no-merge-existing]   ││--incremental--no-incrementalEnable incremental loading of  ││the database.                  ││[default: incremental]         ││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

corpus#

corpusUsage: architxt load corpus [OPTIONS] CORPUS_PATH...Extract a database schema form a corpus.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*corpus_pathCORPUS_PATH...Path to the input corpus.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--languageTEXT                     Language of the input     ││corpus.                   ││[default: French]         ││--corenlp-urlTEXT                     URL of the CoreNLP server.││[default:                 ││http://localhost:9000]    ││--sampleINTEGER RANGE [x>=1]Number of sentences to    ││sample from the corpus.   ││--resolver[umls|mesh|rxnorm|go|hpo]The entity resolver to use││when loading the corpus.  ││--outputPATH                     Path to save the result.││--merge-existing--no-merge-existingShould we merge data if   ││output file already exist ││[default:                 ││no-merge-existing]        ││--incremental--no-incrementalEnable incremental loading││of the database.          ││[default: incremental]    ││--cache--no-cacheEnable caching of the     ││analyzed corpus to prevent││re-parsing.               ││[default: cache]          ││--log--no-logEnable logging to MLFlow.││[default: no-log]        ││--helpShow this message and     ││exit.                     │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

export#

exportUsage: architxt export [OPTIONS] COMMAND [ARGS]...╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮│graphExport the database to Cypher/Bolt compatible database such as Neo4j.                    ││sql  Export the database to SQL compatible database.                                          │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

graph#

graphUsage: architxt export graph [OPTIONS] DATABASE...Export the database to Cypher/Bolt compatible database such as Neo4j.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*databaseDATABASE...Path to load the database.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│*--uriTEXTDatabase connection string.[required]││--usernameTEXTUsername to use for authentication.[default: neo4j]││--passwordTEXTPassword to use for authentication.││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

sql#

sqlUsage: architxt export sql [OPTIONS] DATABASE...Export the database to SQL compatible database.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮│*databaseDATABASE...Path to load the database.[required]│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮│*--uriTEXTDatabase connection string.[required]││--helpShow this message and exit.│╰──────────────────────────────────────────────────────────────────────────────────────────────────╯