common.h 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598
  1. // Various helper functions and utilities
  2. #pragma once
  3. #include "llama.h"
  4. #include <string>
  5. #include <vector>
  6. #include <sstream>
  7. #ifdef _WIN32
  8. #define DIRECTORY_SEPARATOR '\\'
  9. #else
  10. #define DIRECTORY_SEPARATOR '/'
  11. #endif // _WIN32
  12. #define die(msg) do { fputs("error: " msg "\n", stderr); exit(1); } while (0)
  13. #define die_fmt(fmt, ...) do { fprintf(stderr, "error: " fmt "\n", __VA_ARGS__); exit(1); } while (0)
  14. #define print_build_info() do { \
  15. fprintf(stderr, "%s: build = %d (%s)\n", __func__, LLAMA_BUILD_NUMBER, LLAMA_COMMIT); \
  16. fprintf(stderr, "%s: built with %s for %s\n", __func__, LLAMA_COMPILER, LLAMA_BUILD_TARGET); \
  17. } while(0)
  18. #define DEFAULT_MODEL_PATH "models/7B/ggml-model-f16.gguf"
  19. struct common_lora_adapter_info {
  20. std::string path;
  21. float scale;
  22. };
  23. struct common_lora_adapter_container : common_lora_adapter_info {
  24. struct llama_lora_adapter * adapter;
  25. };
  26. // build info
  27. extern int LLAMA_BUILD_NUMBER;
  28. extern char const * LLAMA_COMMIT;
  29. extern char const * LLAMA_COMPILER;
  30. extern char const * LLAMA_BUILD_TARGET;
  31. struct common_control_vector_load_info;
  32. //
  33. // CPU utils
  34. //
  35. struct cpu_params {
  36. int n_threads = -1;
  37. bool cpumask[GGML_MAX_N_THREADS] = {false}; // CPU affinity mask.
  38. bool mask_valid = false; // Default: any CPU
  39. enum ggml_sched_priority priority = GGML_SCHED_PRIO_NORMAL; // Scheduling prio : (0 - normal, 1 - medium, 2 - high, 3 - realtime)
  40. bool strict_cpu = false; // Use strict CPU placement
  41. uint32_t poll = 50; // Polling (busywait) level (0 - no polling, 100 - mostly polling)
  42. };
  43. int32_t cpu_get_num_physical_cores();
  44. int32_t cpu_get_num_math();
  45. //
  46. // Common params
  47. //
  48. enum llama_example {
  49. LLAMA_EXAMPLE_COMMON,
  50. LLAMA_EXAMPLE_SPECULATIVE,
  51. LLAMA_EXAMPLE_MAIN,
  52. LLAMA_EXAMPLE_INFILL,
  53. LLAMA_EXAMPLE_EMBEDDING,
  54. LLAMA_EXAMPLE_PERPLEXITY,
  55. LLAMA_EXAMPLE_RETRIEVAL,
  56. LLAMA_EXAMPLE_PASSKEY,
  57. LLAMA_EXAMPLE_IMATRIX,
  58. LLAMA_EXAMPLE_BENCH,
  59. LLAMA_EXAMPLE_SERVER,
  60. LLAMA_EXAMPLE_CVECTOR_GENERATOR,
  61. LLAMA_EXAMPLE_EXPORT_LORA,
  62. LLAMA_EXAMPLE_LLAVA,
  63. LLAMA_EXAMPLE_LOOKUP,
  64. LLAMA_EXAMPLE_PARALLEL,
  65. LLAMA_EXAMPLE_COUNT,
  66. };
  67. enum common_sampler_type {
  68. COMMON_SAMPLER_TYPE_NONE = 0,
  69. COMMON_SAMPLER_TYPE_DRY = 1,
  70. COMMON_SAMPLER_TYPE_TOP_K = 2,
  71. COMMON_SAMPLER_TYPE_TOP_P = 3,
  72. COMMON_SAMPLER_TYPE_MIN_P = 4,
  73. //COMMON_SAMPLER_TYPE_TFS_Z = 5,
  74. COMMON_SAMPLER_TYPE_TYPICAL_P = 6,
  75. COMMON_SAMPLER_TYPE_TEMPERATURE = 7,
  76. COMMON_SAMPLER_TYPE_XTC = 8,
  77. COMMON_SAMPLER_TYPE_INFILL = 9,
  78. };
  79. // dimensionality reduction methods, used by cvector-generator
  80. enum dimre_method {
  81. DIMRE_METHOD_PCA,
  82. DIMRE_METHOD_MEAN,
  83. };
  84. // sampler parameters
  85. struct common_sampler_params {
  86. uint32_t seed = LLAMA_DEFAULT_SEED; // the seed used to initialize llama_sampler
  87. int32_t n_prev = 64; // number of previous tokens to remember
  88. int32_t n_probs = 0; // if greater than 0, output the probabilities of top n_probs tokens.
  89. int32_t min_keep = 0; // 0 = disabled, otherwise samplers should return at least min_keep tokens
  90. int32_t top_k = 40; // <= 0 to use vocab size
  91. float top_p = 0.95f; // 1.0 = disabled
  92. float min_p = 0.05f; // 0.0 = disabled
  93. float xtc_probability = 0.00f; // 0.0 = disabled
  94. float xtc_threshold = 0.10f; // > 0.5 disables XTC
  95. float typ_p = 1.00f; // typical_p, 1.0 = disabled
  96. float temp = 0.80f; // <= 0.0 to sample greedily, 0.0 to not output probabilities
  97. float dynatemp_range = 0.00f; // 0.0 = disabled
  98. float dynatemp_exponent = 1.00f; // controls how entropy maps to temperature in dynamic temperature sampler
  99. int32_t penalty_last_n = 64; // last n tokens to penalize (0 = disable penalty, -1 = context size)
  100. float penalty_repeat = 1.00f; // 1.0 = disabled
  101. float penalty_freq = 0.00f; // 0.0 = disabled
  102. float penalty_present = 0.00f; // 0.0 = disabled
  103. float dry_multiplier = 0.0f; // 0.0 = disabled; DRY repetition penalty for tokens extending repetition:
  104. float dry_base = 1.75f; // 0.0 = disabled; multiplier * base ^ (length of sequence before token - allowed length)
  105. int32_t dry_allowed_length = 2; // tokens extending repetitions beyond this receive penalty
  106. int32_t dry_penalty_last_n = -1; // how many tokens to scan for repetitions (0 = disable penalty, -1 = context size)
  107. int32_t mirostat = 0; // 0 = disabled, 1 = mirostat, 2 = mirostat 2.0
  108. float mirostat_tau = 5.00f; // target entropy
  109. float mirostat_eta = 0.10f; // learning rate
  110. bool penalize_nl = false; // consider newlines as a repeatable token
  111. bool ignore_eos = false;
  112. bool no_perf = false; // disable performance metrics
  113. std::vector<std::string> dry_sequence_breakers = {"\n", ":", "\"", "*"}; // default sequence breakers for DRY
  114. std::vector<enum common_sampler_type> samplers = {
  115. COMMON_SAMPLER_TYPE_DRY,
  116. COMMON_SAMPLER_TYPE_TOP_K,
  117. COMMON_SAMPLER_TYPE_TYPICAL_P,
  118. COMMON_SAMPLER_TYPE_TOP_P,
  119. COMMON_SAMPLER_TYPE_MIN_P,
  120. COMMON_SAMPLER_TYPE_XTC,
  121. COMMON_SAMPLER_TYPE_TEMPERATURE,
  122. };
  123. std::string grammar; // optional BNF-like grammar to constrain sampling
  124. std::vector<llama_logit_bias> logit_bias; // logit biases to apply
  125. // print the parameters into a string
  126. std::string print() const;
  127. };
  128. struct common_params {
  129. int32_t n_predict = -1; // new tokens to predict
  130. int32_t n_ctx = 0; // context size
  131. int32_t n_batch = 2048; // logical batch size for prompt processing (must be >=32 to use BLAS)
  132. int32_t n_ubatch = 512; // physical batch size for prompt processing (must be >=32 to use BLAS)
  133. int32_t n_keep = 0; // number of tokens to keep from initial prompt
  134. int32_t n_draft = 5; // number of tokens to draft during speculative decoding
  135. int32_t n_chunks = -1; // max number of chunks to process (-1 = unlimited)
  136. int32_t n_parallel = 1; // number of parallel sequences to decode
  137. int32_t n_sequences = 1; // number of sequences to decode
  138. float p_split = 0.1f; // speculative decoding split probability
  139. int32_t n_gpu_layers = -1; // number of layers to store in VRAM (-1 - use default)
  140. int32_t n_gpu_layers_draft = -1; // number of layers to store in VRAM for the draft model (-1 - use default)
  141. int32_t main_gpu = 0; // the GPU that is used for scratch and small tensors
  142. float tensor_split[128] = {0}; // how split tensors should be distributed across GPUs
  143. int32_t grp_attn_n = 1; // group-attention factor
  144. int32_t grp_attn_w = 512; // group-attention width
  145. int32_t n_print = -1; // print token count every n tokens (-1 = disabled)
  146. float rope_freq_base = 0.0f; // RoPE base frequency
  147. float rope_freq_scale = 0.0f; // RoPE frequency scaling factor
  148. float yarn_ext_factor = -1.0f; // YaRN extrapolation mix factor
  149. float yarn_attn_factor = 1.0f; // YaRN magnitude scaling factor
  150. float yarn_beta_fast = 32.0f; // YaRN low correction dim
  151. float yarn_beta_slow = 1.0f; // YaRN high correction dim
  152. int32_t yarn_orig_ctx = 0; // YaRN original context length
  153. float defrag_thold = -1.0f; // KV cache defragmentation threshold
  154. struct cpu_params cpuparams;
  155. struct cpu_params cpuparams_batch;
  156. struct cpu_params draft_cpuparams;
  157. struct cpu_params draft_cpuparams_batch;
  158. ggml_backend_sched_eval_callback cb_eval = nullptr;
  159. void * cb_eval_user_data = nullptr;
  160. ggml_numa_strategy numa = GGML_NUMA_STRATEGY_DISABLED;
  161. enum llama_split_mode split_mode = LLAMA_SPLIT_MODE_LAYER; // how to split the model across GPUs
  162. enum llama_rope_scaling_type rope_scaling_type = LLAMA_ROPE_SCALING_TYPE_UNSPECIFIED;
  163. enum llama_pooling_type pooling_type = LLAMA_POOLING_TYPE_UNSPECIFIED; // pooling type for embeddings
  164. enum llama_attention_type attention_type = LLAMA_ATTENTION_TYPE_UNSPECIFIED; // attention type for embeddings
  165. struct common_sampler_params sparams;
  166. std::string model = ""; // model path // NOLINT
  167. std::string model_draft = ""; // draft model for speculative decoding // NOLINT
  168. std::string model_alias = "unknown"; // model alias // NOLINT
  169. std::string model_url = ""; // model url to download // NOLINT
  170. std::string hf_token = ""; // HF token // NOLINT
  171. std::string hf_repo = ""; // HF repo // NOLINT
  172. std::string hf_file = ""; // HF file // NOLINT
  173. std::string prompt = ""; // NOLINT
  174. std::string prompt_file = ""; // store the external prompt file name // NOLINT
  175. std::string path_prompt_cache = ""; // path to file for saving/loading prompt eval state // NOLINT
  176. std::string input_prefix = ""; // string to prefix user inputs with // NOLINT
  177. std::string input_suffix = ""; // string to suffix user inputs with // NOLINT
  178. std::string logdir = ""; // directory in which to save YAML log files // NOLINT
  179. std::string lookup_cache_static = ""; // path of static ngram cache file for lookup decoding // NOLINT
  180. std::string lookup_cache_dynamic = ""; // path of dynamic ngram cache file for lookup decoding // NOLINT
  181. std::string logits_file = ""; // file for saving *all* logits // NOLINT
  182. std::string rpc_servers = ""; // comma separated list of RPC servers // NOLINT
  183. std::vector<std::string> in_files; // all input files
  184. std::vector<std::string> antiprompt; // strings upon which more user input is prompted (a.k.a. reverse prompts)
  185. std::vector<llama_model_kv_override> kv_overrides;
  186. bool lora_init_without_apply = false; // only load lora to memory, but do not apply it to ctx (user can manually apply lora later using llama_lora_adapter_apply)
  187. std::vector<common_lora_adapter_info> lora_adapters; // lora adapter path with user defined scale
  188. std::vector<common_control_vector_load_info> control_vectors; // control vector with user defined scale
  189. int32_t verbosity = 0;
  190. int32_t control_vector_layer_start = -1; // layer range for control vector
  191. int32_t control_vector_layer_end = -1; // layer range for control vector
  192. int32_t ppl_stride = 0; // stride for perplexity calculations. If left at 0, the pre-existing approach will be used.
  193. int32_t ppl_output_type = 0; // = 0 -> ppl output is as usual, = 1 -> ppl output is num_tokens, ppl, one per line
  194. // (which is more convenient to use for plotting)
  195. //
  196. bool hellaswag = false; // compute HellaSwag score over random tasks from datafile supplied in prompt
  197. size_t hellaswag_tasks = 400; // number of tasks to use when computing the HellaSwag score
  198. bool winogrande = false; // compute Winogrande score over random tasks from datafile supplied in prompt
  199. size_t winogrande_tasks = 0; // number of tasks to use when computing the Winogrande score. If 0, all tasks will be computed
  200. bool multiple_choice = false; // compute TruthfulQA score over random tasks from datafile supplied in prompt
  201. size_t multiple_choice_tasks = 0; // number of tasks to use when computing the TruthfulQA score. If 0, all tasks will be computed
  202. bool kl_divergence = false; // compute KL divergence
  203. bool usage = false; // print usage
  204. bool use_color = false; // use color to distinguish generations and inputs
  205. bool special = false; // enable special token output
  206. bool interactive = false; // interactive mode
  207. bool interactive_first = false; // wait for user input immediately
  208. bool conversation = false; // conversation mode (does not print special tokens and suffix/prefix)
  209. bool prompt_cache_all = false; // save user input and generations to prompt cache
  210. bool prompt_cache_ro = false; // open the prompt cache read-only and do not update it
  211. bool escape = true; // escape "\n", "\r", "\t", "\'", "\"", and "\\"
  212. bool multiline_input = false; // reverse the usage of `\`
  213. bool simple_io = false; // improves compatibility with subprocesses and limited consoles
  214. bool cont_batching = true; // insert new sequences for decoding on-the-fly
  215. bool flash_attn = false; // flash attention
  216. bool no_perf = false; // disable performance metrics
  217. bool ctx_shift = true; // context shift on inifinite text generation
  218. bool input_prefix_bos = false; // prefix BOS to user inputs, preceding input_prefix
  219. bool logits_all = false; // return logits for all tokens in the batch
  220. bool use_mmap = true; // use mmap for faster loads
  221. bool use_mlock = false; // use mlock to keep model in memory
  222. bool verbose_prompt = false; // print prompt tokens before generation
  223. bool display_prompt = true; // print prompt before generation
  224. bool dump_kv_cache = false; // dump the KV cache contents for debugging purposes
  225. bool no_kv_offload = false; // disable KV offloading
  226. bool warmup = true; // warmup run
  227. bool check_tensors = false; // validate tensor data
  228. std::string cache_type_k = "f16"; // KV cache data type for the K
  229. std::string cache_type_v = "f16"; // KV cache data type for the V
  230. // multimodal models (see examples/llava)
  231. std::string mmproj = ""; // path to multimodal projector // NOLINT
  232. std::vector<std::string> image; // path to image file(s)
  233. // embedding
  234. bool embedding = false; // get only sentence embedding
  235. int32_t embd_normalize = 2; // normalisation for embeddings (-1=none, 0=max absolute int16, 1=taxicab, 2=euclidean, >2=p-norm)
  236. std::string embd_out = ""; // empty = default, "array" = [[],[]...], "json" = openai style, "json+" = same "json" + cosine similarity matrix
  237. std::string embd_sep = "\n"; // separator of embeddings
  238. bool reranking = false; // enable reranking support on server
  239. // server params
  240. int32_t port = 8080; // server listens on this network port
  241. int32_t timeout_read = 600; // http read timeout in seconds
  242. int32_t timeout_write = timeout_read; // http write timeout in seconds
  243. int32_t n_threads_http = -1; // number of threads to process HTTP requests (TODO: support threadpool)
  244. int32_t n_cache_reuse = 0; // min chunk size to reuse from the cache via KV shifting
  245. std::string hostname = "127.0.0.1";
  246. std::string public_path = ""; // NOLINT
  247. std::string chat_template = ""; // NOLINT
  248. bool enable_chat_template = true;
  249. std::vector<std::string> api_keys;
  250. std::string ssl_file_key = ""; // NOLINT
  251. std::string ssl_file_cert = ""; // NOLINT
  252. // "advanced" endpoints are disabled by default for better security
  253. bool webui = true;
  254. bool endpoint_slots = false;
  255. bool endpoint_props = false; // only control POST requests, not GET
  256. bool endpoint_metrics = false;
  257. bool log_json = false;
  258. std::string slot_save_path;
  259. float slot_prompt_similarity = 0.5f;
  260. // batched-bench params
  261. bool is_pp_shared = false;
  262. std::vector<int32_t> n_pp;
  263. std::vector<int32_t> n_tg;
  264. std::vector<int32_t> n_pl;
  265. // retrieval params
  266. std::vector<std::string> context_files; // context files to embed
  267. int32_t chunk_size = 64; // chunk size for context embedding
  268. std::string chunk_separator = "\n"; // chunk separator for context embedding
  269. // passkey params
  270. int32_t n_junk = 250; // number of times to repeat the junk text
  271. int32_t i_pos = -1; // position of the passkey in the junk text
  272. // imatrix params
  273. std::string out_file = "imatrix.dat"; // save the resulting imatrix to this file
  274. int32_t n_out_freq = 10; // output the imatrix every n_out_freq iterations
  275. int32_t n_save_freq = 0; // save the imatrix every n_save_freq iterations
  276. int32_t i_chunk = 0; // start processing from this chunk
  277. bool process_output = false; // collect data for the output tensor
  278. bool compute_ppl = true; // whether to compute perplexity
  279. // cvector-generator params
  280. int n_pca_batch = 100;
  281. int n_pca_iterations = 1000;
  282. dimre_method cvector_dimre_method = DIMRE_METHOD_PCA;
  283. std::string cvector_outfile = "control_vector.gguf";
  284. std::string cvector_positive_file = "examples/cvector-generator/positive.txt";
  285. std::string cvector_negative_file = "examples/cvector-generator/negative.txt";
  286. bool spm_infill = false; // suffix/prefix/middle pattern for infill
  287. std::string lora_outfile = "ggml-lora-merged-f16.gguf";
  288. // batched-bench params
  289. bool batched_bench_output_jsonl = false;
  290. };
  291. // call once at the start of a program if it uses libcommon
  292. // initializes the logging system and prints info about the build
  293. void common_init();
  294. std::string common_params_get_system_info(const common_params & params);
  295. bool parse_cpu_range(const std::string & range, bool(&boolmask)[GGML_MAX_N_THREADS]);
  296. bool parse_cpu_mask(const std::string & mask, bool(&boolmask)[GGML_MAX_N_THREADS]);
  297. void postprocess_cpu_params(cpu_params & cpuparams, const cpu_params * role_model = nullptr);
  298. bool set_process_priority(enum ggml_sched_priority prio);
  299. //
  300. // String utils
  301. //
  302. #ifdef __GNUC__
  303. #ifdef __MINGW32__
  304. #define LLAMA_COMMON_ATTRIBUTE_FORMAT(...) __attribute__((format(gnu_printf, __VA_ARGS__)))
  305. #else
  306. #define LLAMA_COMMON_ATTRIBUTE_FORMAT(...) __attribute__((format(printf, __VA_ARGS__)))
  307. #endif
  308. #else
  309. #define LLAMA_COMMON_ATTRIBUTE_FORMAT(...)
  310. #endif
  311. LLAMA_COMMON_ATTRIBUTE_FORMAT(1, 2)
  312. std::string string_format(const char * fmt, ...);
  313. std::string string_strip(const std::string & str);
  314. std::string string_get_sortable_timestamp();
  315. void string_replace_all(std::string & s, const std::string & search, const std::string & replace);
  316. template<class T>
  317. static std::vector<T> string_split(const std::string & str, char delim) {
  318. static_assert(!std::is_same<T, std::string>::value, "Please use the specialized version for std::string");
  319. std::vector<T> values;
  320. std::istringstream str_stream(str);
  321. std::string token;
  322. while (std::getline(str_stream, token, delim)) {
  323. T value;
  324. std::istringstream token_stream(token);
  325. token_stream >> value;
  326. values.push_back(value);
  327. }
  328. return values;
  329. }
  330. template<>
  331. std::vector<std::string> string_split<std::string>(const std::string & input, char separator)
  332. {
  333. std::vector<std::string> parts;
  334. size_t begin_pos = 0;
  335. size_t separator_pos = input.find(separator);
  336. while (separator_pos != std::string::npos) {
  337. std::string part = input.substr(begin_pos, separator_pos - begin_pos);
  338. parts.emplace_back(part);
  339. begin_pos = separator_pos + 1;
  340. separator_pos = input.find(separator, begin_pos);
  341. }
  342. parts.emplace_back(input.substr(begin_pos, separator_pos - begin_pos));
  343. return parts;
  344. }
  345. bool string_parse_kv_override(const char * data, std::vector<llama_model_kv_override> & overrides);
  346. void string_process_escapes(std::string & input);
  347. std::string string_from(bool value);
  348. std::string string_from(const std::vector<int> & values);
  349. std::string string_from(const struct llama_context * ctx, const std::vector<llama_token> & tokens);
  350. std::string string_from(const struct llama_context * ctx, const struct llama_batch & batch);
  351. //
  352. // Filesystem utils
  353. //
  354. bool fs_validate_filename(const std::string & filename);
  355. bool fs_create_directory_with_parents(const std::string & path);
  356. std::string fs_get_cache_directory();
  357. std::string fs_get_cache_file(const std::string & filename);
  358. //
  359. // Model utils
  360. //
  361. struct common_init_result {
  362. struct llama_model * model = nullptr;
  363. struct llama_context * context = nullptr;
  364. std::vector<common_lora_adapter_container> lora_adapters;
  365. };
  366. struct common_init_result common_init_from_params(common_params & params);
  367. struct llama_model_params common_model_params_to_llama (const common_params & params);
  368. struct llama_context_params common_context_params_to_llama(const common_params & params);
  369. struct ggml_threadpool_params ggml_threadpool_params_from_cpu_params(const cpu_params & params);
  370. struct llama_model * common_load_model_from_url(const char * model_url, const char * path_model, const char * hf_token, const struct llama_model_params & params);
  371. struct llama_model * common_load_model_from_hf(const char * repo, const char * file, const char * path_model, const char * hf_token, const struct llama_model_params & params);
  372. // clear LoRA adapters from context, then apply new list of adapters
  373. void common_lora_adapters_apply(struct llama_context * ctx, std::vector<common_lora_adapter_container> & lora_adapters);
  374. // Batch utils
  375. void common_batch_clear(struct llama_batch & batch);
  376. void common_batch_add(
  377. struct llama_batch & batch,
  378. llama_token id,
  379. llama_pos pos,
  380. const std::vector<llama_seq_id> & seq_ids,
  381. bool logits);
  382. //
  383. // Vocab utils
  384. //
  385. // tokenizes a string into a vector of tokens
  386. // should work similar to Python's `tokenizer.encode`
  387. std::vector<llama_token> common_tokenize(
  388. const struct llama_context * ctx,
  389. const std::string & text,
  390. bool add_special,
  391. bool parse_special = false);
  392. std::vector<llama_token> common_tokenize(
  393. const struct llama_model * model,
  394. const std::string & text,
  395. bool add_special,
  396. bool parse_special = false);
  397. // tokenizes a token into a piece, optionally renders special/control tokens
  398. // should work similar to Python's `tokenizer.id_to_piece`
  399. std::string common_token_to_piece(
  400. const struct llama_context * ctx,
  401. llama_token token,
  402. bool special = true);
  403. // detokenizes a vector of tokens into a string
  404. // should work similar to Python's `tokenizer.decode`
  405. // optionally renders special/control tokens
  406. std::string common_detokenize(
  407. llama_context * ctx,
  408. const std::vector<llama_token> & tokens,
  409. bool special = true);
  410. //
  411. // Chat template utils
  412. //
  413. // same with llama_chat_message, but uses std::string
  414. struct common_chat_msg {
  415. std::string role;
  416. std::string content;
  417. };
  418. // Check if the template supplied via "--chat-template" is supported or not. Returns true if it's valid
  419. bool common_chat_verify_template(const std::string & tmpl);
  420. // CPP wrapper for llama_chat_apply_template
  421. // If the built-in template is not supported, we default to chatml
  422. // If the custom "tmpl" is not supported, we throw an error
  423. std::string common_chat_apply_template(const struct llama_model * model,
  424. const std::string & tmpl,
  425. const std::vector<common_chat_msg> & chat,
  426. bool add_ass);
  427. // Format single message, while taking into account the position of that message in chat history
  428. std::string common_chat_format_single(const struct llama_model * model,
  429. const std::string & tmpl,
  430. const std::vector<common_chat_msg> & past_msg,
  431. const common_chat_msg & new_msg,
  432. bool add_ass);
  433. // Returns an example of formatted chat
  434. std::string common_chat_format_example(const struct llama_model * model,
  435. const std::string & tmpl);
  436. //
  437. // KV cache utils
  438. //
  439. // Dump the KV cache view with the number of sequences per cell.
  440. void common_kv_cache_dump_view(const llama_kv_cache_view & view, int row_size = 80);
  441. // Dump the KV cache view showing individual sequences in each cell (long output).
  442. void common_kv_cache_dump_view_seqs(const llama_kv_cache_view & view, int row_size = 40);
  443. //
  444. // Embedding utils
  445. //
  446. void common_embd_normalize(const float * inp, float * out, int n, int embd_norm = 2);
  447. float common_embd_similarity_cos(const float * embd1, const float * embd2, int n);
  448. //
  449. // Control vector utils
  450. //
  451. struct common_control_vector_data {
  452. int n_embd;
  453. // stores data for layers [1, n_layer] where n_layer = data.size() / n_embd
  454. std::vector<float> data;
  455. };
  456. struct common_control_vector_load_info {
  457. float strength;
  458. std::string fname;
  459. };
  460. // Load control vectors, scale each by strength, and add them together.
  461. // On error, returns {-1, empty}
  462. common_control_vector_data common_control_vector_load(const std::vector<common_control_vector_load_info> & load_infos);
  463. //
  464. // Split utils
  465. //
  466. static const char * const LLM_KV_SPLIT_NO = "split.no";
  467. static const char * const LLM_KV_SPLIT_COUNT = "split.count";
  468. static const char * const LLM_KV_SPLIT_TENSORS_COUNT = "split.tensors.count";
  469. //
  470. // YAML utils
  471. //
  472. void yaml_dump_vector_float (FILE * stream, const char * prop_name, const std::vector<float> & data);
  473. void yaml_dump_vector_int (FILE * stream, const char * prop_name, const std::vector<int> & data);
  474. void yaml_dump_string_multiline(FILE * stream, const char * prop_name, const char * data);
  475. void yaml_dump_non_result_info(
  476. FILE * stream, const common_params & params, const llama_context * lctx,
  477. const std::string & timestamp, const std::vector<int> & prompt_tokens, const char * model_desc);