common.cpp 39 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010
  1. #include "common.h"
  2. #include <cassert>
  3. #include <iostream>
  4. #include <cstring>
  5. #include <fstream>
  6. #include <string>
  7. #include <iterator>
  8. #include <algorithm>
  9. #include <sstream>
  10. #include <unordered_set>
  11. #include <regex>
  12. #if defined(__APPLE__) && defined(__MACH__)
  13. #include <sys/types.h>
  14. #include <sys/sysctl.h>
  15. #endif
  16. #if defined(_WIN32)
  17. #define WIN32_LEAN_AND_MEAN
  18. #define NOMINMAX
  19. #include <windows.h>
  20. #include <fcntl.h>
  21. #include <io.h>
  22. #else
  23. #include <sys/ioctl.h>
  24. #include <unistd.h>
  25. #include <wchar.h>
  26. #endif
  27. #if defined(_MSC_VER)
  28. #pragma warning(disable: 4244 4267) // possible loss of data
  29. #endif
  30. int32_t get_num_physical_cores() {
  31. #ifdef __linux__
  32. // enumerate the set of thread siblings, num entries is num cores
  33. std::unordered_set<std::string> siblings;
  34. for (uint32_t cpu=0; cpu < UINT32_MAX; ++cpu) {
  35. std::ifstream thread_siblings("/sys/devices/system/cpu"
  36. + std::to_string(cpu) + "/topology/thread_siblings");
  37. if (!thread_siblings.is_open()) {
  38. break; // no more cpus
  39. }
  40. std::string line;
  41. if (std::getline(thread_siblings, line)) {
  42. siblings.insert(line);
  43. }
  44. }
  45. if (siblings.size() > 0) {
  46. return static_cast<int32_t>(siblings.size());
  47. }
  48. #elif defined(__APPLE__) && defined(__MACH__)
  49. int32_t num_physical_cores;
  50. size_t len = sizeof(num_physical_cores);
  51. int result = sysctlbyname("hw.perflevel0.physicalcpu", &num_physical_cores, &len, NULL, 0);
  52. if (result == 0) {
  53. return num_physical_cores;
  54. }
  55. result = sysctlbyname("hw.physicalcpu", &num_physical_cores, &len, NULL, 0);
  56. if (result == 0) {
  57. return num_physical_cores;
  58. }
  59. #elif defined(_WIN32)
  60. //TODO: Implement
  61. #endif
  62. unsigned int n_threads = std::thread::hardware_concurrency();
  63. return n_threads > 0 ? (n_threads <= 4 ? n_threads : n_threads / 2) : 4;
  64. }
  65. void process_escapes(std::string& input) {
  66. std::size_t input_len = input.length();
  67. std::size_t output_idx = 0;
  68. for (std::size_t input_idx = 0; input_idx < input_len; ++input_idx) {
  69. if (input[input_idx] == '\\' && input_idx + 1 < input_len) {
  70. switch (input[++input_idx]) {
  71. case 'n': input[output_idx++] = '\n'; break;
  72. case 'r': input[output_idx++] = '\r'; break;
  73. case 't': input[output_idx++] = '\t'; break;
  74. case '\'': input[output_idx++] = '\''; break;
  75. case '\"': input[output_idx++] = '\"'; break;
  76. case '\\': input[output_idx++] = '\\'; break;
  77. default: input[output_idx++] = '\\';
  78. input[output_idx++] = input[input_idx]; break;
  79. }
  80. } else {
  81. input[output_idx++] = input[input_idx];
  82. }
  83. }
  84. input.resize(output_idx);
  85. }
  86. bool gpt_params_parse(int argc, char ** argv, gpt_params & params) {
  87. bool invalid_param = false;
  88. bool escape_prompt = false;
  89. std::string arg;
  90. gpt_params default_params;
  91. const std::string arg_prefix = "--";
  92. for (int i = 1; i < argc; i++) {
  93. arg = argv[i];
  94. if (arg.compare(0, arg_prefix.size(), arg_prefix) == 0) {
  95. std::replace(arg.begin(), arg.end(), '_', '-');
  96. }
  97. if (arg == "-s" || arg == "--seed") {
  98. if (++i >= argc) {
  99. invalid_param = true;
  100. break;
  101. }
  102. params.seed = std::stoul(argv[i]);
  103. } else if (arg == "-t" || arg == "--threads") {
  104. if (++i >= argc) {
  105. invalid_param = true;
  106. break;
  107. }
  108. params.n_threads = std::stoi(argv[i]);
  109. } else if (arg == "-p" || arg == "--prompt") {
  110. if (++i >= argc) {
  111. invalid_param = true;
  112. break;
  113. }
  114. params.prompt = argv[i];
  115. } else if (arg == "-e") {
  116. escape_prompt = true;
  117. } else if (arg == "--prompt-cache") {
  118. if (++i >= argc) {
  119. invalid_param = true;
  120. break;
  121. }
  122. params.path_prompt_cache = argv[i];
  123. } else if (arg == "--prompt-cache-all") {
  124. params.prompt_cache_all = true;
  125. } else if (arg == "--prompt-cache-ro") {
  126. params.prompt_cache_ro = true;
  127. } else if (arg == "-f" || arg == "--file") {
  128. if (++i >= argc) {
  129. invalid_param = true;
  130. break;
  131. }
  132. std::ifstream file(argv[i]);
  133. if (!file) {
  134. fprintf(stderr, "error: failed to open file '%s'\n", argv[i]);
  135. invalid_param = true;
  136. break;
  137. }
  138. std::copy(std::istreambuf_iterator<char>(file), std::istreambuf_iterator<char>(), back_inserter(params.prompt));
  139. if (params.prompt.back() == '\n') {
  140. params.prompt.pop_back();
  141. }
  142. } else if (arg == "-n" || arg == "--n-predict") {
  143. if (++i >= argc) {
  144. invalid_param = true;
  145. break;
  146. }
  147. params.n_predict = std::stoi(argv[i]);
  148. } else if (arg == "--top-k") {
  149. if (++i >= argc) {
  150. invalid_param = true;
  151. break;
  152. }
  153. params.top_k = std::stoi(argv[i]);
  154. } else if (arg == "-c" || arg == "--ctx-size") {
  155. if (++i >= argc) {
  156. invalid_param = true;
  157. break;
  158. }
  159. params.n_ctx = std::stoi(argv[i]);
  160. } else if (arg == "-gqa" || arg == "--gqa") {
  161. if (++i >= argc) {
  162. invalid_param = true;
  163. break;
  164. }
  165. params.n_gqa = std::stoi(argv[i]);
  166. } else if (arg == "--rope-freq-base") {
  167. if (++i >= argc) {
  168. invalid_param = true;
  169. break;
  170. }
  171. params.rope_freq_base = std::stof(argv[i]);
  172. } else if (arg == "--rope-freq-scale") {
  173. if (++i >= argc) {
  174. invalid_param = true;
  175. break;
  176. }
  177. params.rope_freq_scale = std::stof(argv[i]);
  178. } else if (arg == "--memory-f32") {
  179. params.memory_f16 = false;
  180. } else if (arg == "--top-p") {
  181. if (++i >= argc) {
  182. invalid_param = true;
  183. break;
  184. }
  185. params.top_p = std::stof(argv[i]);
  186. } else if (arg == "--temp") {
  187. if (++i >= argc) {
  188. invalid_param = true;
  189. break;
  190. }
  191. params.temp = std::stof(argv[i]);
  192. } else if (arg == "--tfs") {
  193. if (++i >= argc) {
  194. invalid_param = true;
  195. break;
  196. }
  197. params.tfs_z = std::stof(argv[i]);
  198. } else if (arg == "--typical") {
  199. if (++i >= argc) {
  200. invalid_param = true;
  201. break;
  202. }
  203. params.typical_p = std::stof(argv[i]);
  204. } else if (arg == "--repeat-last-n") {
  205. if (++i >= argc) {
  206. invalid_param = true;
  207. break;
  208. }
  209. params.repeat_last_n = std::stoi(argv[i]);
  210. } else if (arg == "--repeat-penalty") {
  211. if (++i >= argc) {
  212. invalid_param = true;
  213. break;
  214. }
  215. params.repeat_penalty = std::stof(argv[i]);
  216. } else if (arg == "--frequency-penalty") {
  217. if (++i >= argc) {
  218. invalid_param = true;
  219. break;
  220. }
  221. params.frequency_penalty = std::stof(argv[i]);
  222. } else if (arg == "--presence-penalty") {
  223. if (++i >= argc) {
  224. invalid_param = true;
  225. break;
  226. }
  227. params.presence_penalty = std::stof(argv[i]);
  228. } else if (arg == "--mirostat") {
  229. if (++i >= argc) {
  230. invalid_param = true;
  231. break;
  232. }
  233. params.mirostat = std::stoi(argv[i]);
  234. } else if (arg == "--mirostat-lr") {
  235. if (++i >= argc) {
  236. invalid_param = true;
  237. break;
  238. }
  239. params.mirostat_eta = std::stof(argv[i]);
  240. } else if (arg == "--mirostat-ent") {
  241. if (++i >= argc) {
  242. invalid_param = true;
  243. break;
  244. }
  245. params.mirostat_tau = std::stof(argv[i]);
  246. } else if (arg == "--cfg-negative-prompt") {
  247. if (++i >= argc) {
  248. invalid_param = true;
  249. break;
  250. }
  251. params.cfg_negative_prompt = argv[i];
  252. } else if (arg == "--cfg-scale") {
  253. if (++i >= argc) {
  254. invalid_param = true;
  255. break;
  256. }
  257. params.cfg_scale = std::stof(argv[i]);
  258. } else if (arg == "-b" || arg == "--batch-size") {
  259. if (++i >= argc) {
  260. invalid_param = true;
  261. break;
  262. }
  263. params.n_batch = std::stoi(argv[i]);
  264. params.n_batch = std::min(512, params.n_batch);
  265. } else if (arg == "--keep") {
  266. if (++i >= argc) {
  267. invalid_param = true;
  268. break;
  269. }
  270. params.n_keep = std::stoi(argv[i]);
  271. } else if (arg == "--chunks") {
  272. if (++i >= argc) {
  273. invalid_param = true;
  274. break;
  275. }
  276. params.n_chunks = std::stoi(argv[i]);
  277. } else if (arg == "-m" || arg == "--model") {
  278. if (++i >= argc) {
  279. invalid_param = true;
  280. break;
  281. }
  282. params.model = argv[i];
  283. } else if (arg == "-a" || arg == "--alias") {
  284. if (++i >= argc) {
  285. invalid_param = true;
  286. break;
  287. }
  288. params.model_alias = argv[i];
  289. } else if (arg == "--lora") {
  290. if (++i >= argc) {
  291. invalid_param = true;
  292. break;
  293. }
  294. params.lora_adapter = argv[i];
  295. params.use_mmap = false;
  296. } else if (arg == "--lora-base") {
  297. if (++i >= argc) {
  298. invalid_param = true;
  299. break;
  300. }
  301. params.lora_base = argv[i];
  302. } else if (arg == "-i" || arg == "--interactive") {
  303. params.interactive = true;
  304. } else if (arg == "--embedding") {
  305. params.embedding = true;
  306. } else if (arg == "--interactive-first") {
  307. params.interactive_first = true;
  308. } else if (arg == "-ins" || arg == "--instruct") {
  309. params.instruct = true;
  310. } else if (arg == "--multiline-input") {
  311. params.multiline_input = true;
  312. } else if (arg == "--color") {
  313. params.use_color = true;
  314. } else if (arg == "--mlock") {
  315. params.use_mlock = true;
  316. } else if (arg == "--gpu-layers" || arg == "-ngl" || arg == "--n-gpu-layers") {
  317. if (++i >= argc) {
  318. invalid_param = true;
  319. break;
  320. }
  321. #ifdef LLAMA_SUPPORTS_GPU_OFFLOAD
  322. params.n_gpu_layers = std::stoi(argv[i]);
  323. #else
  324. fprintf(stderr, "warning: not compiled with GPU offload support, --n-gpu-layers option will be ignored\n");
  325. fprintf(stderr, "warning: see main README.md for information on enabling GPU BLAS support\n");
  326. #endif
  327. } else if (arg == "--main-gpu" || arg == "-mg") {
  328. if (++i >= argc) {
  329. invalid_param = true;
  330. break;
  331. }
  332. #ifdef GGML_USE_CUBLAS
  333. params.main_gpu = std::stoi(argv[i]);
  334. #else
  335. fprintf(stderr, "warning: llama.cpp was compiled without cuBLAS. It is not possible to set a main GPU.\n");
  336. #endif
  337. } else if (arg == "--tensor-split" || arg == "-ts") {
  338. if (++i >= argc) {
  339. invalid_param = true;
  340. break;
  341. }
  342. #ifdef GGML_USE_CUBLAS
  343. std::string arg_next = argv[i];
  344. // split string by , and /
  345. const std::regex regex{R"([,/]+)"};
  346. std::sregex_token_iterator it{arg_next.begin(), arg_next.end(), regex, -1};
  347. std::vector<std::string> split_arg{it, {}};
  348. GGML_ASSERT(split_arg.size() <= LLAMA_MAX_DEVICES);
  349. for (size_t i = 0; i < LLAMA_MAX_DEVICES; ++i) {
  350. if (i < split_arg.size()) {
  351. params.tensor_split[i] = std::stof(split_arg[i]);
  352. } else {
  353. params.tensor_split[i] = 0.0f;
  354. }
  355. }
  356. #else
  357. fprintf(stderr, "warning: llama.cpp was compiled without cuBLAS. It is not possible to set a tensor split.\n");
  358. #endif // GGML_USE_CUBLAS
  359. } else if (arg == "--low-vram" || arg == "-lv") {
  360. #ifdef GGML_USE_CUBLAS
  361. params.low_vram = true;
  362. #else
  363. fprintf(stderr, "warning: llama.cpp was compiled without cuBLAS. It is not possible to set lower vram usage.\n");
  364. #endif // GGML_USE_CUBLAS
  365. } else if (arg == "--no-mmap") {
  366. params.use_mmap = false;
  367. } else if (arg == "--mtest") {
  368. params.mem_test = true;
  369. } else if (arg == "--numa") {
  370. params.numa = true;
  371. } else if (arg == "--export") {
  372. params.export_cgraph = true;
  373. } else if (arg == "--verbose-prompt") {
  374. params.verbose_prompt = true;
  375. } else if (arg == "-r" || arg == "--reverse-prompt") {
  376. if (++i >= argc) {
  377. invalid_param = true;
  378. break;
  379. }
  380. params.antiprompt.push_back(argv[i]);
  381. } else if (arg == "--perplexity") {
  382. params.perplexity = true;
  383. } else if (arg == "--perplexity-lines") {
  384. params.perplexity_lines = true;
  385. } else if (arg == "--ignore-eos") {
  386. params.logit_bias[llama_token_eos()] = -INFINITY;
  387. } else if (arg == "--no-penalize-nl") {
  388. params.penalize_nl = false;
  389. } else if (arg == "-l" || arg == "--logit-bias") {
  390. if (++i >= argc) {
  391. invalid_param = true;
  392. break;
  393. }
  394. std::stringstream ss(argv[i]);
  395. llama_token key;
  396. char sign;
  397. std::string value_str;
  398. try {
  399. if (ss >> key && ss >> sign && std::getline(ss, value_str) && (sign == '+' || sign == '-')) {
  400. params.logit_bias[key] = std::stof(value_str) * ((sign == '-') ? -1.0f : 1.0f);
  401. } else {
  402. throw std::exception();
  403. }
  404. } catch (const std::exception&) {
  405. invalid_param = true;
  406. break;
  407. }
  408. } else if (arg == "-h" || arg == "--help") {
  409. gpt_print_usage(argc, argv, default_params);
  410. exit(0);
  411. } else if (arg == "--random-prompt") {
  412. params.random_prompt = true;
  413. } else if (arg == "--in-prefix") {
  414. if (++i >= argc) {
  415. invalid_param = true;
  416. break;
  417. }
  418. params.input_prefix = argv[i];
  419. } else if (arg == "--in-suffix") {
  420. if (++i >= argc) {
  421. invalid_param = true;
  422. break;
  423. }
  424. params.input_suffix = argv[i];
  425. } else {
  426. fprintf(stderr, "error: unknown argument: %s\n", arg.c_str());
  427. gpt_print_usage(argc, argv, default_params);
  428. exit(1);
  429. }
  430. }
  431. if (invalid_param) {
  432. fprintf(stderr, "error: invalid parameter for argument: %s\n", arg.c_str());
  433. gpt_print_usage(argc, argv, default_params);
  434. exit(1);
  435. }
  436. if (params.prompt_cache_all &&
  437. (params.interactive || params.interactive_first ||
  438. params.instruct)) {
  439. fprintf(stderr, "error: --prompt-cache-all not supported in interactive mode yet\n");
  440. gpt_print_usage(argc, argv, default_params);
  441. exit(1);
  442. }
  443. if (escape_prompt) {
  444. process_escapes(params.prompt);
  445. process_escapes(params.input_prefix);
  446. process_escapes(params.input_suffix);
  447. }
  448. return true;
  449. }
  450. void gpt_print_usage(int /*argc*/, char ** argv, const gpt_params & params) {
  451. fprintf(stdout, "usage: %s [options]\n", argv[0]);
  452. fprintf(stdout, "\n");
  453. fprintf(stdout, "options:\n");
  454. fprintf(stdout, " -h, --help show this help message and exit\n");
  455. fprintf(stdout, " -i, --interactive run in interactive mode\n");
  456. fprintf(stdout, " --interactive-first run in interactive mode and wait for input right away\n");
  457. fprintf(stdout, " -ins, --instruct run in instruction mode (use with Alpaca models)\n");
  458. fprintf(stdout, " --multiline-input allows you to write or paste multiple lines without ending each in '\\'\n");
  459. fprintf(stdout, " -r PROMPT, --reverse-prompt PROMPT\n");
  460. fprintf(stdout, " halt generation at PROMPT, return control in interactive mode\n");
  461. fprintf(stdout, " (can be specified more than once for multiple prompts).\n");
  462. fprintf(stdout, " --color colorise output to distinguish prompt and user input from generations\n");
  463. fprintf(stdout, " -s SEED, --seed SEED RNG seed (default: -1, use random seed for < 0)\n");
  464. fprintf(stdout, " -t N, --threads N number of threads to use during computation (default: %d)\n", params.n_threads);
  465. fprintf(stdout, " -p PROMPT, --prompt PROMPT\n");
  466. fprintf(stdout, " prompt to start generation with (default: empty)\n");
  467. fprintf(stdout, " -e process prompt escapes sequences (\\n, \\r, \\t, \\', \\\", \\\\)\n");
  468. fprintf(stdout, " --prompt-cache FNAME file to cache prompt state for faster startup (default: none)\n");
  469. fprintf(stdout, " --prompt-cache-all if specified, saves user input and generations to cache as well.\n");
  470. fprintf(stdout, " not supported with --interactive or other interactive options\n");
  471. fprintf(stdout, " --prompt-cache-ro if specified, uses the prompt cache but does not update it.\n");
  472. fprintf(stdout, " --random-prompt start with a randomized prompt.\n");
  473. fprintf(stdout, " --in-prefix STRING string to prefix user inputs with (default: empty)\n");
  474. fprintf(stdout, " --in-suffix STRING string to suffix after user inputs with (default: empty)\n");
  475. fprintf(stdout, " -f FNAME, --file FNAME\n");
  476. fprintf(stdout, " prompt file to start generation.\n");
  477. fprintf(stdout, " -n N, --n-predict N number of tokens to predict (default: %d, -1 = infinity)\n", params.n_predict);
  478. fprintf(stdout, " -c N, --ctx-size N size of the prompt context (default: %d)\n", params.n_ctx);
  479. fprintf(stdout, " -b N, --batch-size N batch size for prompt processing (default: %d)\n", params.n_batch);
  480. fprintf(stdout, " -gqa N, --gqa N grouped-query attention factor (TEMP!!! use 8 for LLaMAv2 70B) (default: %d)\n", params.n_gqa);
  481. fprintf(stdout, " --top-k N top-k sampling (default: %d, 0 = disabled)\n", params.top_k);
  482. fprintf(stdout, " --top-p N top-p sampling (default: %.1f, 1.0 = disabled)\n", (double)params.top_p);
  483. fprintf(stdout, " --tfs N tail free sampling, parameter z (default: %.1f, 1.0 = disabled)\n", (double)params.tfs_z);
  484. fprintf(stdout, " --typical N locally typical sampling, parameter p (default: %.1f, 1.0 = disabled)\n", (double)params.typical_p);
  485. fprintf(stdout, " --repeat-last-n N last n tokens to consider for penalize (default: %d, 0 = disabled, -1 = ctx_size)\n", params.repeat_last_n);
  486. fprintf(stdout, " --repeat-penalty N penalize repeat sequence of tokens (default: %.1f, 1.0 = disabled)\n", (double)params.repeat_penalty);
  487. fprintf(stdout, " --presence-penalty N repeat alpha presence penalty (default: %.1f, 0.0 = disabled)\n", (double)params.presence_penalty);
  488. fprintf(stdout, " --frequency-penalty N repeat alpha frequency penalty (default: %.1f, 0.0 = disabled)\n", (double)params.frequency_penalty);
  489. fprintf(stdout, " --mirostat N use Mirostat sampling.\n");
  490. fprintf(stdout, " Top K, Nucleus, Tail Free and Locally Typical samplers are ignored if used.\n");
  491. fprintf(stdout, " (default: %d, 0 = disabled, 1 = Mirostat, 2 = Mirostat 2.0)\n", params.mirostat);
  492. fprintf(stdout, " --mirostat-lr N Mirostat learning rate, parameter eta (default: %.1f)\n", (double)params.mirostat_eta);
  493. fprintf(stdout, " --mirostat-ent N Mirostat target entropy, parameter tau (default: %.1f)\n", (double)params.mirostat_tau);
  494. fprintf(stdout, " -l TOKEN_ID(+/-)BIAS, --logit-bias TOKEN_ID(+/-)BIAS\n");
  495. fprintf(stdout, " modifies the likelihood of token appearing in the completion,\n");
  496. fprintf(stdout, " i.e. `--logit-bias 15043+1` to increase likelihood of token ' Hello',\n");
  497. fprintf(stdout, " or `--logit-bias 15043-1` to decrease likelihood of token ' Hello'\n");
  498. fprintf(stdout, " --cfg-negative-prompt PROMPT \n");
  499. fprintf(stdout, " negative prompt to use for guidance. (default: empty)\n");
  500. fprintf(stdout, " --cfg-scale N strength of guidance (default: %f, 1.0 = disable)\n", params.cfg_scale);
  501. fprintf(stdout, " --rope-freq-base N RoPE base frequency (default: %.1f)\n", params.rope_freq_base);
  502. fprintf(stdout, " --rope-freq-scale N RoPE frequency scaling factor (default: %g)\n", params.rope_freq_scale);
  503. fprintf(stdout, " --ignore-eos ignore end of stream token and continue generating (implies --logit-bias 2-inf)\n");
  504. fprintf(stdout, " --no-penalize-nl do not penalize newline token\n");
  505. fprintf(stdout, " --memory-f32 use f32 instead of f16 for memory key+value (default: disabled)\n");
  506. fprintf(stdout, " not recommended: doubles context memory required and no measurable increase in quality\n");
  507. fprintf(stdout, " --temp N temperature (default: %.1f)\n", (double)params.temp);
  508. fprintf(stdout, " --perplexity compute perplexity over each ctx window of the prompt\n");
  509. fprintf(stdout, " --perplexity-lines compute perplexity over each line of the prompt\n");
  510. fprintf(stdout, " --keep number of tokens to keep from the initial prompt (default: %d, -1 = all)\n", params.n_keep);
  511. fprintf(stdout, " --chunks N max number of chunks to process (default: %d, -1 = all)\n", params.n_chunks);
  512. if (llama_mlock_supported()) {
  513. fprintf(stdout, " --mlock force system to keep model in RAM rather than swapping or compressing\n");
  514. }
  515. if (llama_mmap_supported()) {
  516. fprintf(stdout, " --no-mmap do not memory-map model (slower load but may reduce pageouts if not using mlock)\n");
  517. }
  518. fprintf(stdout, " --numa attempt optimizations that help on some NUMA systems\n");
  519. fprintf(stdout, " if run without this previously, it is recommended to drop the system page cache before using this\n");
  520. fprintf(stdout, " see https://github.com/ggerganov/llama.cpp/issues/1437\n");
  521. #ifdef LLAMA_SUPPORTS_GPU_OFFLOAD
  522. fprintf(stdout, " -ngl N, --n-gpu-layers N\n");
  523. fprintf(stdout, " number of layers to store in VRAM\n");
  524. fprintf(stdout, " -ts SPLIT --tensor-split SPLIT\n");
  525. fprintf(stdout, " how to split tensors across multiple GPUs, comma-separated list of proportions, e.g. 3,1\n");
  526. fprintf(stdout, " -mg i, --main-gpu i the GPU to use for scratch and small tensors\n" );
  527. fprintf(stdout, " -lv, --low-vram don't allocate VRAM scratch buffer\n" );
  528. #endif
  529. fprintf(stdout, " --mtest compute maximum memory usage\n");
  530. fprintf(stdout, " --export export the computation graph to 'llama.ggml'\n");
  531. fprintf(stdout, " --verbose-prompt print prompt before generation\n");
  532. fprintf(stdout, " --lora FNAME apply LoRA adapter (implies --no-mmap)\n");
  533. fprintf(stdout, " --lora-base FNAME optional model to use as a base for the layers modified by the LoRA adapter\n");
  534. fprintf(stdout, " -m FNAME, --model FNAME\n");
  535. fprintf(stdout, " model path (default: %s)\n", params.model.c_str());
  536. fprintf(stdout, "\n");
  537. }
  538. std::string gpt_random_prompt(std::mt19937 & rng) {
  539. const int r = rng() % 10;
  540. switch (r) {
  541. case 0: return "So";
  542. case 1: return "Once upon a time";
  543. case 2: return "When";
  544. case 3: return "The";
  545. case 4: return "After";
  546. case 5: return "If";
  547. case 6: return "import";
  548. case 7: return "He";
  549. case 8: return "She";
  550. case 9: return "They";
  551. default: return "To";
  552. }
  553. return "The";
  554. }
  555. // TODO: not great allocating this every time
  556. std::vector<llama_token> llama_tokenize(struct llama_context * ctx, const std::string & text, bool add_bos) {
  557. // initialize to prompt numer of chars, since n_tokens <= n_prompt_chars
  558. std::vector<llama_token> res(text.size() + (int) add_bos);
  559. const int n = llama_tokenize(ctx, text.c_str(), res.data(), res.size(), add_bos);
  560. assert(n >= 0);
  561. res.resize(n);
  562. return res;
  563. }
  564. struct llama_context_params llama_context_params_from_gpt_params(const gpt_params & params) {
  565. auto lparams = llama_context_default_params();
  566. lparams.n_ctx = params.n_ctx;
  567. lparams.n_batch = params.n_batch;
  568. lparams.n_gqa = params.n_gqa;
  569. lparams.n_gpu_layers = params.n_gpu_layers;
  570. lparams.main_gpu = params.main_gpu;
  571. lparams.tensor_split = params.tensor_split;
  572. lparams.low_vram = params.low_vram;
  573. lparams.seed = params.seed;
  574. lparams.f16_kv = params.memory_f16;
  575. lparams.use_mmap = params.use_mmap;
  576. lparams.use_mlock = params.use_mlock;
  577. lparams.logits_all = params.perplexity;
  578. lparams.embedding = params.embedding;
  579. lparams.rope_freq_base = params.rope_freq_base;
  580. lparams.rope_freq_scale = params.rope_freq_scale;
  581. return lparams;
  582. }
  583. std::tuple<struct llama_model *, struct llama_context *> llama_init_from_gpt_params(const gpt_params & params) {
  584. auto lparams = llama_context_params_from_gpt_params(params);
  585. llama_model * model = llama_load_model_from_file(params.model.c_str(), lparams);
  586. if (model == NULL) {
  587. fprintf(stderr, "%s: error: failed to load model '%s'\n", __func__, params.model.c_str());
  588. return std::make_tuple(nullptr, nullptr);
  589. }
  590. llama_context * lctx = llama_new_context_with_model(model, lparams);
  591. if (lctx == NULL) {
  592. fprintf(stderr, "%s: error: failed to create context with model '%s'\n", __func__, params.model.c_str());
  593. llama_free_model(model);
  594. return std::make_tuple(nullptr, nullptr);
  595. }
  596. if (!params.lora_adapter.empty()) {
  597. int err = llama_model_apply_lora_from_file(model,
  598. params.lora_adapter.c_str(),
  599. params.lora_base.empty() ? NULL : params.lora_base.c_str(),
  600. params.n_threads);
  601. if (err != 0) {
  602. fprintf(stderr, "%s: error: failed to apply lora adapter\n", __func__);
  603. llama_free(lctx);
  604. llama_free_model(model);
  605. return std::make_tuple(nullptr, nullptr);
  606. }
  607. }
  608. return std::make_tuple(model, lctx);
  609. }
  610. void console_init(console_state & con_st) {
  611. #if defined(_WIN32)
  612. // Windows-specific console initialization
  613. DWORD dwMode = 0;
  614. con_st.hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
  615. if (con_st.hConsole == INVALID_HANDLE_VALUE || !GetConsoleMode(con_st.hConsole, &dwMode)) {
  616. con_st.hConsole = GetStdHandle(STD_ERROR_HANDLE);
  617. if (con_st.hConsole != INVALID_HANDLE_VALUE && (!GetConsoleMode(con_st.hConsole, &dwMode))) {
  618. con_st.hConsole = NULL;
  619. }
  620. }
  621. if (con_st.hConsole) {
  622. // Enable ANSI colors on Windows 10+
  623. if (con_st.use_color && !(dwMode & ENABLE_VIRTUAL_TERMINAL_PROCESSING)) {
  624. SetConsoleMode(con_st.hConsole, dwMode | ENABLE_VIRTUAL_TERMINAL_PROCESSING);
  625. }
  626. // Set console output codepage to UTF8
  627. SetConsoleOutputCP(CP_UTF8);
  628. }
  629. HANDLE hConIn = GetStdHandle(STD_INPUT_HANDLE);
  630. if (hConIn != INVALID_HANDLE_VALUE && GetConsoleMode(hConIn, &dwMode)) {
  631. // Set console input codepage to UTF16
  632. _setmode(_fileno(stdin), _O_WTEXT);
  633. // Turn off ICANON (ENABLE_LINE_INPUT) and ECHO (ENABLE_ECHO_INPUT)
  634. dwMode &= ~(ENABLE_LINE_INPUT | ENABLE_ECHO_INPUT);
  635. SetConsoleMode(hConIn, dwMode);
  636. }
  637. #else
  638. // POSIX-specific console initialization
  639. struct termios new_termios;
  640. tcgetattr(STDIN_FILENO, &con_st.prev_state);
  641. new_termios = con_st.prev_state;
  642. new_termios.c_lflag &= ~(ICANON | ECHO);
  643. new_termios.c_cc[VMIN] = 1;
  644. new_termios.c_cc[VTIME] = 0;
  645. tcsetattr(STDIN_FILENO, TCSANOW, &new_termios);
  646. con_st.tty = fopen("/dev/tty", "w+");
  647. if (con_st.tty != nullptr) {
  648. con_st.out = con_st.tty;
  649. }
  650. setlocale(LC_ALL, "");
  651. #endif
  652. }
  653. void console_cleanup(console_state & con_st) {
  654. // Reset console color
  655. console_set_color(con_st, CONSOLE_COLOR_DEFAULT);
  656. #if !defined(_WIN32)
  657. if (con_st.tty != nullptr) {
  658. con_st.out = stdout;
  659. fclose(con_st.tty);
  660. con_st.tty = nullptr;
  661. }
  662. // Restore the terminal settings on POSIX systems
  663. tcsetattr(STDIN_FILENO, TCSANOW, &con_st.prev_state);
  664. #endif
  665. }
  666. /* Keep track of current color of output, and emit ANSI code if it changes. */
  667. void console_set_color(console_state & con_st, console_color_t color) {
  668. if (con_st.use_color && con_st.color != color) {
  669. fflush(stdout);
  670. switch(color) {
  671. case CONSOLE_COLOR_DEFAULT:
  672. fprintf(con_st.out, ANSI_COLOR_RESET);
  673. break;
  674. case CONSOLE_COLOR_PROMPT:
  675. fprintf(con_st.out, ANSI_COLOR_YELLOW);
  676. break;
  677. case CONSOLE_COLOR_USER_INPUT:
  678. fprintf(con_st.out, ANSI_BOLD ANSI_COLOR_GREEN);
  679. break;
  680. case CONSOLE_COLOR_ERROR:
  681. fprintf(con_st.out, ANSI_BOLD ANSI_COLOR_RED);
  682. break;
  683. }
  684. con_st.color = color;
  685. fflush(con_st.out);
  686. }
  687. }
  688. char32_t getchar32() {
  689. #if defined(_WIN32)
  690. HANDLE hConsole = GetStdHandle(STD_INPUT_HANDLE);
  691. wchar_t high_surrogate = 0;
  692. while (true) {
  693. INPUT_RECORD record;
  694. DWORD count;
  695. if (!ReadConsoleInputW(hConsole, &record, 1, &count) || count == 0) {
  696. return WEOF;
  697. }
  698. if (record.EventType == KEY_EVENT && record.Event.KeyEvent.bKeyDown) {
  699. wchar_t wc = record.Event.KeyEvent.uChar.UnicodeChar;
  700. if (wc == 0) {
  701. continue;
  702. }
  703. if ((wc >= 0xD800) && (wc <= 0xDBFF)) { // Check if wc is a high surrogate
  704. high_surrogate = wc;
  705. continue;
  706. } else if ((wc >= 0xDC00) && (wc <= 0xDFFF)) { // Check if wc is a low surrogate
  707. if (high_surrogate != 0) { // Check if we have a high surrogate
  708. return ((high_surrogate - 0xD800) << 10) + (wc - 0xDC00) + 0x10000;
  709. }
  710. }
  711. high_surrogate = 0; // Reset the high surrogate
  712. return static_cast<char32_t>(wc);
  713. }
  714. }
  715. #else
  716. wchar_t wc = getwchar();
  717. if (static_cast<wint_t>(wc) == WEOF) {
  718. return WEOF;
  719. }
  720. #if WCHAR_MAX == 0xFFFF
  721. if ((wc >= 0xD800) && (wc <= 0xDBFF)) { // Check if wc is a high surrogate
  722. wchar_t low_surrogate = getwchar();
  723. if ((low_surrogate >= 0xDC00) && (low_surrogate <= 0xDFFF)) { // Check if the next wchar is a low surrogate
  724. return (static_cast<char32_t>(wc & 0x03FF) << 10) + (low_surrogate & 0x03FF) + 0x10000;
  725. }
  726. }
  727. if ((wc >= 0xD800) && (wc <= 0xDFFF)) { // Invalid surrogate pair
  728. return 0xFFFD; // Return the replacement character U+FFFD
  729. }
  730. #endif
  731. return static_cast<char32_t>(wc);
  732. #endif
  733. }
  734. void pop_cursor(console_state & con_st) {
  735. #if defined(_WIN32)
  736. if (con_st.hConsole != NULL) {
  737. CONSOLE_SCREEN_BUFFER_INFO bufferInfo;
  738. GetConsoleScreenBufferInfo(con_st.hConsole, &bufferInfo);
  739. COORD newCursorPosition = bufferInfo.dwCursorPosition;
  740. if (newCursorPosition.X == 0) {
  741. newCursorPosition.X = bufferInfo.dwSize.X - 1;
  742. newCursorPosition.Y -= 1;
  743. } else {
  744. newCursorPosition.X -= 1;
  745. }
  746. SetConsoleCursorPosition(con_st.hConsole, newCursorPosition);
  747. return;
  748. }
  749. #endif
  750. putc('\b', con_st.out);
  751. }
  752. int estimateWidth(char32_t codepoint) {
  753. #if defined(_WIN32)
  754. return 1;
  755. #else
  756. return wcwidth(codepoint);
  757. #endif
  758. }
  759. int put_codepoint(console_state & con_st, const char* utf8_codepoint, size_t length, int expectedWidth) {
  760. #if defined(_WIN32)
  761. CONSOLE_SCREEN_BUFFER_INFO bufferInfo;
  762. if (!GetConsoleScreenBufferInfo(con_st.hConsole, &bufferInfo)) {
  763. // go with the default
  764. return expectedWidth;
  765. }
  766. COORD initialPosition = bufferInfo.dwCursorPosition;
  767. DWORD nNumberOfChars = length;
  768. WriteConsole(con_st.hConsole, utf8_codepoint, nNumberOfChars, &nNumberOfChars, NULL);
  769. CONSOLE_SCREEN_BUFFER_INFO newBufferInfo;
  770. GetConsoleScreenBufferInfo(con_st.hConsole, &newBufferInfo);
  771. // Figure out our real position if we're in the last column
  772. if (utf8_codepoint[0] != 0x09 && initialPosition.X == newBufferInfo.dwSize.X - 1) {
  773. DWORD nNumberOfChars;
  774. WriteConsole(con_st.hConsole, &" \b", 2, &nNumberOfChars, NULL);
  775. GetConsoleScreenBufferInfo(con_st.hConsole, &newBufferInfo);
  776. }
  777. int width = newBufferInfo.dwCursorPosition.X - initialPosition.X;
  778. if (width < 0) {
  779. width += newBufferInfo.dwSize.X;
  780. }
  781. return width;
  782. #else
  783. // we can trust expectedWidth if we've got one
  784. if (expectedWidth >= 0 || con_st.tty == nullptr) {
  785. fwrite(utf8_codepoint, length, 1, con_st.out);
  786. return expectedWidth;
  787. }
  788. fputs("\033[6n", con_st.tty); // Query cursor position
  789. int x1, x2, y1, y2;
  790. int results = 0;
  791. results = fscanf(con_st.tty, "\033[%d;%dR", &y1, &x1);
  792. fwrite(utf8_codepoint, length, 1, con_st.tty);
  793. fputs("\033[6n", con_st.tty); // Query cursor position
  794. results += fscanf(con_st.tty, "\033[%d;%dR", &y2, &x2);
  795. if (results != 4) {
  796. return expectedWidth;
  797. }
  798. int width = x2 - x1;
  799. if (width < 0) {
  800. // Calculate the width considering text wrapping
  801. struct winsize w;
  802. ioctl(STDOUT_FILENO, TIOCGWINSZ, &w);
  803. width += w.ws_col;
  804. }
  805. return width;
  806. #endif
  807. }
  808. void replace_last(console_state & con_st, char ch) {
  809. #if defined(_WIN32)
  810. pop_cursor(con_st);
  811. put_codepoint(con_st, &ch, 1, 1);
  812. #else
  813. fprintf(con_st.out, "\b%c", ch);
  814. #endif
  815. }
  816. void append_utf8(char32_t ch, std::string & out) {
  817. if (ch <= 0x7F) {
  818. out.push_back(static_cast<unsigned char>(ch));
  819. } else if (ch <= 0x7FF) {
  820. out.push_back(static_cast<unsigned char>(0xC0 | ((ch >> 6) & 0x1F)));
  821. out.push_back(static_cast<unsigned char>(0x80 | (ch & 0x3F)));
  822. } else if (ch <= 0xFFFF) {
  823. out.push_back(static_cast<unsigned char>(0xE0 | ((ch >> 12) & 0x0F)));
  824. out.push_back(static_cast<unsigned char>(0x80 | ((ch >> 6) & 0x3F)));
  825. out.push_back(static_cast<unsigned char>(0x80 | (ch & 0x3F)));
  826. } else if (ch <= 0x10FFFF) {
  827. out.push_back(static_cast<unsigned char>(0xF0 | ((ch >> 18) & 0x07)));
  828. out.push_back(static_cast<unsigned char>(0x80 | ((ch >> 12) & 0x3F)));
  829. out.push_back(static_cast<unsigned char>(0x80 | ((ch >> 6) & 0x3F)));
  830. out.push_back(static_cast<unsigned char>(0x80 | (ch & 0x3F)));
  831. } else {
  832. // Invalid Unicode code point
  833. }
  834. }
  835. // Helper function to remove the last UTF-8 character from a string
  836. void pop_back_utf8_char(std::string & line) {
  837. if (line.empty()) {
  838. return;
  839. }
  840. size_t pos = line.length() - 1;
  841. // Find the start of the last UTF-8 character (checking up to 4 bytes back)
  842. for (size_t i = 0; i < 3 && pos > 0; ++i, --pos) {
  843. if ((line[pos] & 0xC0) != 0x80) break; // Found the start of the character
  844. }
  845. line.erase(pos);
  846. }
  847. bool console_readline(console_state & con_st, std::string & line) {
  848. console_set_color(con_st, CONSOLE_COLOR_USER_INPUT);
  849. if (con_st.out != stdout) {
  850. fflush(stdout);
  851. }
  852. line.clear();
  853. std::vector<int> widths;
  854. bool is_special_char = false;
  855. bool end_of_stream = false;
  856. char32_t input_char;
  857. while (true) {
  858. fflush(con_st.out); // Ensure all output is displayed before waiting for input
  859. input_char = getchar32();
  860. if (input_char == '\r' || input_char == '\n') {
  861. break;
  862. }
  863. if (input_char == (char32_t) WEOF || input_char == 0x04 /* Ctrl+D*/) {
  864. end_of_stream = true;
  865. break;
  866. }
  867. if (is_special_char) {
  868. console_set_color(con_st, CONSOLE_COLOR_USER_INPUT);
  869. replace_last(con_st, line.back());
  870. is_special_char = false;
  871. }
  872. if (input_char == '\033') { // Escape sequence
  873. char32_t code = getchar32();
  874. if (code == '[' || code == 0x1B) {
  875. // Discard the rest of the escape sequence
  876. while ((code = getchar32()) != (char32_t) WEOF) {
  877. if ((code >= 'A' && code <= 'Z') || (code >= 'a' && code <= 'z') || code == '~') {
  878. break;
  879. }
  880. }
  881. }
  882. } else if (input_char == 0x08 || input_char == 0x7F) { // Backspace
  883. if (!widths.empty()) {
  884. int count;
  885. do {
  886. count = widths.back();
  887. widths.pop_back();
  888. // Move cursor back, print space, and move cursor back again
  889. for (int i = 0; i < count; i++) {
  890. replace_last(con_st, ' ');
  891. pop_cursor(con_st);
  892. }
  893. pop_back_utf8_char(line);
  894. } while (count == 0 && !widths.empty());
  895. }
  896. } else {
  897. int offset = line.length();
  898. append_utf8(input_char, line);
  899. int width = put_codepoint(con_st, line.c_str() + offset, line.length() - offset, estimateWidth(input_char));
  900. if (width < 0) {
  901. width = 0;
  902. }
  903. widths.push_back(width);
  904. }
  905. if (!line.empty() && (line.back() == '\\' || line.back() == '/')) {
  906. console_set_color(con_st, CONSOLE_COLOR_PROMPT);
  907. replace_last(con_st, line.back());
  908. is_special_char = true;
  909. }
  910. }
  911. bool has_more = con_st.multiline_input;
  912. if (is_special_char) {
  913. replace_last(con_st, ' ');
  914. pop_cursor(con_st);
  915. char last = line.back();
  916. line.pop_back();
  917. if (last == '\\') {
  918. line += '\n';
  919. fputc('\n', con_st.out);
  920. has_more = !has_more;
  921. } else {
  922. // llama will just eat the single space, it won't act as a space
  923. if (line.length() == 1 && line.back() == ' ') {
  924. line.clear();
  925. pop_cursor(con_st);
  926. }
  927. has_more = false;
  928. }
  929. } else {
  930. if (end_of_stream) {
  931. has_more = false;
  932. } else {
  933. line += '\n';
  934. fputc('\n', con_st.out);
  935. }
  936. }
  937. fflush(con_st.out);
  938. return has_more;
  939. }